Developer CD Series 1994 November: Tool Chest

home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1994 November: Tool Chest / Dev.CD Nov 94.toast / New System Software Extensions / OpenDoc A6 / OpenDoc Parts Framework / Documentation / Debug Component < prev next >
MacBinary | 1994-04-21 | 117.9 KB | [ONLN/HLX2]
open in:
MacOS 8.1 extracted |
Win98 extracted |
DOS extracted
browse contents |
view JSON data |
view as text

This file was processed as: MacBinary (archive/macBinary).
Confidence	Program	Detection	Match Type	Support
`10%`	dexvert	MacBinary `(archive/macBinary)`	fallback	Supported
`100%`	file	MacBinary II, inited, Wed Apr 20 06:24:54 1994, modified Thu Apr 21 08:06:39 1994, creator 'HLX2', type 'ONLN', 112422 bytes "Debug Component" , at 0x1b7a6 7998 bytes resource	default (weak)
`99%`	file	data	default
`100%`	TrID	MacBinary 2	default (weak)
`100%`	siegfried	fmt/1762 MacBinary (II)	default
`100%`	lsar	MacBinary	default
id metadata
key	value
macFileType	`[ONLN]`
macFileCreator	`[HLX2]`
hex view
+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 0f 44 65 62 75 67 20 | 43 6f 6d 70 6f 6e 65 6e |..Debug |Componen|
|00000010| 74 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |t.......|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 4f 4e 4c 4e 48 4c 58 | 32 01 00 00 00 00 00 00 |.ONLNHLX|2.......|
|00000050| 00 00 00 00 01 b7 26 00 | 00 1f 3e a9 da b3 76 a9 |......&.|..>...v.|
|00000060| dc 1c cf 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 4a ab 00 00 |........|....J...|
|00000080| 44 65 62 75 67 20 43 6f | 6d 70 6f 6e 65 6e 74 0d |Debug Co|mponent.|
|00000090| 0d 49 6e 74 72 6f 64 75 | 63 74 69 6f 6e 0d 54 68 |.Introdu|ction.Th|
|000000a0| 65 20 44 65 62 75 67 20 | 43 6f 6d 70 6f 6e 65 6e |e Debug |Componen|
|000000b0| 74 20 63 6f 6e 74 61 69 | 6e 73 20 74 6f 6f 6c 73 |t contai|ns tools|
|000000c0| 20 74 68 61 74 20 61 72 | 65 20 75 73 65 66 75 6c | that ar|e useful|
|000000d0| 20 64 75 72 69 6e 67 20 | 74 68 65 20 74 65 73 74 | during |the test|
|000000e0| 69 6e 67 20 61 6e 64 20 | 64 65 62 75 67 67 69 6e |ing and |debuggin|
|000000f0| 67 20 6f 66 20 4f 50 46 | 20 70 61 72 74 73 2e 0d |g of OPF| parts..|
|00000100| 54 68 65 20 44 65 62 75 | 67 20 43 6f 6d 70 6f 6e |The Debu|g Compon|
|00000110| 65 6e 74 20 70 72 6f 76 | 69 64 65 73 20 74 68 65 |ent prov|ides the|
|00000120| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 64 65 62 75 67 | followi|ng debug|
|00000130| 20 74 6f 6f 6c 73 3a 0d | a5 09 44 65 62 75 67 20 | tools:.|..Debug |
|00000140| 63 6f 6e 73 6f 6c 65 73 | 0d a5 09 4d 61 63 72 6f |consoles|...Macro|
|00000150| 73 20 77 68 69 63 68 20 | 64 69 72 65 63 74 20 65 |s which |direct e|
|00000160| 72 72 6f 72 73 20 74 6f | 20 74 68 65 20 64 65 62 |rrors to| the deb|
|00000170| 75 67 20 63 6f 6e 73 6f | 6c 65 0d a5 09 44 65 62 |ug conso|le...Deb|
|00000180| 75 67 20 73 74 72 65 61 | 6d 73 0d a5 09 46 75 6e |ug strea|ms...Fun|
|00000190| 63 74 69 6f 6e 20 74 72 | 61 63 69 6e 67 20 66 61 |ction tr|acing fa|
|000001a0| 63 69 6c 69 74 69 65 73 | 0d 44 65 62 75 67 20 43 |cilities|.Debug C|
|000001b0| 6f 6d 70 6f 6e 65 6e 74 | 20 4f 76 65 72 76 69 65 |omponent| Overvie|
|000001c0| 77 0d 54 68 65 20 44 65 | 62 75 67 20 43 6f 6d 70 |w.The De|bug Comp|
|000001d0| 6f 6e 65 6e 74 20 63 6f | 6e 74 61 69 6e 73 20 36 |onent co|ntains 6|
|000001e0| 20 63 6c 61 73 73 65 73 | 20 61 6e 64 20 34 35 20 | classes| and 45 |
|000001f0| 6d 65 74 68 6f 64 73 2e | 20 59 6f 75 20 77 69 6c |methods.| You wil|
|00000200| 6c 20 6c 69 6b 65 6c 79 | 20 6e 65 65 64 20 74 6f |l likely| need to|
|00000210| 20 6b 6e 6f 77 20 61 62 | 6f 75 74 2c 20 61 6e 64 | know ab|out, and|
|00000220| 20 75 73 65 2c 20 74 68 | 65 20 6d 61 6a 6f 72 69 | use, th|e majori|
|00000230| 74 79 20 6f 66 20 74 68 | 65 20 44 65 62 75 67 20 |ty of th|e Debug |
|00000240| 43 6f 6d 70 6f 6e 65 6e | 74 20 63 6c 61 73 73 65 |Componen|t classe|
|00000250| 73 20 61 6e 64 20 6d 65 | 74 68 6f 64 73 2e 0d 44 |s and me|thods..D|
|00000260| 69 72 65 63 74 6f 72 79 | 0d 46 57 44 65 62 75 67 |irectory|.FWDebug|
|00000270| 0d 48 65 72 69 74 61 67 | 65 0d 46 57 5f 43 44 65 |.Heritag|e.FW_CDe|
|00000280| 62 75 67 43 6f 6e 73 6f | 6c 65 09 37 0d 46 57 5f |bugConso|le.7.FW_|
|00000290| 43 44 65 62 75 67 53 74 | 72 65 61 6d 09 31 31 0d |CDebugSt|ream.11.|
|000002a0| a5 20 46 57 5f 43 42 75 | 66 66 65 72 44 65 62 75 |. FW_CBu|fferDebu|
|000002b0| 67 53 74 72 65 61 6d 09 | 31 35 0d a5 20 46 57 5f |gStream.|15.. FW_|
|000002c0| 43 46 69 6c 65 44 65 62 | 75 67 53 74 72 65 61 6d |CFileDeb|ugStream|
|000002d0| 09 31 37 0d a5 20 46 57 | 5f 43 4e 75 6c 6c 44 65 |.17.. FW|_CNullDe|
|000002e0| 62 75 67 53 74 72 65 61 | 6d 09 31 39 0d 46 57 5f |bugStrea|m.19.FW_|
|000002f0| 43 54 72 61 63 65 52 75 | 6e 74 69 6d 65 09 32 31 |CTraceRu|ntime.21|
|00000300| 0d 44 65 62 75 67 20 43 | 6f 6d 70 6f 6e 65 6e 74 |.Debug C|omponent|
|00000310| 20 63 6c 61 73 73 65 73 | 0d 54 68 65 72 65 20 61 | classes|.There a|
|00000320| 72 65 20 73 69 78 20 63 | 6c 61 73 73 65 73 20 69 |re six c|lasses i|
|00000330| 6e 20 74 68 65 20 44 65 | 62 75 67 20 43 6f 6d 70 |n the De|bug Comp|
|00000340| 6f 6e 65 6e 74 2e 20 45 | 78 63 65 70 74 20 66 6f |onent. E|xcept fo|
|00000350| 72 20 74 68 65 20 73 75 | 62 63 6c 61 73 73 65 73 |r the su|bclasses|
|00000360| 20 6f 66 20 74 68 65 20 | 61 62 73 74 72 61 63 74 | of the |abstract|
|00000370| 20 62 61 73 65 20 63 6c | 61 73 73 2c 20 46 57 5f | base cl|ass, FW_|
|00000380| 43 44 65 62 75 67 53 74 | 72 65 61 6d 2c 20 74 68 |CDebugSt|ream, th|
|00000390| 65 20 44 65 62 75 67 20 | 43 6f 6d 70 6f 6e 65 6e |e Debug |Componen|
|000003a0| 74 20 63 6c 61 73 73 65 | 73 20 64 6f 20 6e 6f 74 |t classe|s do not|
|000003b0| 20 64 65 73 63 65 6e 64 | 20 66 72 6f 6d 20 61 20 | descend| from a |
|000003c0| 73 69 6e 67 6c 65 20 72 | 6f 6f 74 2c 20 62 75 74 |single r|oot, but|
|000003d0| 20 61 72 65 20 72 61 74 | 68 65 72 20 61 6c 6c 20 | are rat|her all |
|000003e0| 61 74 20 74 68 65 20 72 | 6f 6f 74 20 6c 65 76 65 |at the r|oot leve|
|000003f0| 6c 20 6f 66 20 74 68 65 | 20 44 65 62 75 67 20 43 |l of the| Debug C|
|00000400| 6f 6d 70 6f 6e 65 6e 74 | 2e 0d 46 69 67 75 72 65 |omponent|..Figure|
|00000410| 20 31 2d 31 20 73 68 6f | 77 73 20 74 68 65 20 68 | 1-1 sho|ws the h|
|00000420| 69 65 72 61 72 63 68 79 | 20 66 6f 72 20 74 68 65 |ierarchy| for the|
|00000430| 20 44 65 62 75 67 20 43 | 6f 6d 70 6f 6e 65 6e 74 | Debug C|omponent|
|00000440| 2e 0d 46 69 67 75 72 65 | 20 31 15 31 20 44 65 62 |..Figure| 1.1 Deb|
|00000450| 75 67 20 43 6f 6d 70 6f | 6e 65 6e 74 20 68 69 65 |ug Compo|nent hie|
|00000460| 72 61 72 63 68 79 0d 44 | 65 62 75 67 20 43 6f 6d |rarchy.D|ebug Com|
|00000470| 70 6f 6e 65 6e 74 20 63 | 6f 6e 63 65 70 74 73 0d |ponent c|oncepts.|
|00000480| 57 68 69 6c 65 20 61 20 | 70 61 72 74 20 69 73 20 |While a |part is |
|00000490| 62 65 69 6e 67 20 64 65 | 76 65 6c 6f 70 65 64 2c |being de|veloped,|
|000004a0| 20 69 74 20 63 61 6e 20 | 62 65 20 76 65 72 79 20 | it can |be very |
|000004b0| 75 73 65 66 75 6c 20 74 | 6f 20 77 72 69 74 65 20 |useful t|o write |
|000004c0| 63 6f 64 65 20 77 68 6f | 73 65 20 73 6f 6c 65 20 |code who|se sole |
|000004d0| 70 75 72 70 6f 73 65 20 | 69 73 20 74 6f 20 61 69 |purpose |is to ai|
|000004e0| 64 20 69 6e 20 74 68 65 | 20 74 65 73 74 69 6e 67 |d in the| testing|
|000004f0| 20 61 6e 64 20 64 65 62 | 75 67 67 69 6e 67 20 6f | and deb|ugging o|
|00000500| 66 20 74 68 65 20 70 61 | 72 74 2e 20 41 73 73 65 |f the pa|rt. Asse|
|00000510| 72 74 69 6f 6e 73 20 61 | 72 65 20 75 73 65 64 20 |rtions a|re used |
|00000520| 69 6e 20 4f 50 46 20 61 | 6e 64 20 4f 50 46 2d 62 |in OPF a|nd OPF-b|
|00000530| 61 73 65 64 20 70 61 72 | 74 73 20 74 6f 20 64 65 |ased par|ts to de|
|00000540| 74 65 63 74 20 6c 6f 67 | 69 63 20 65 72 72 6f 72 |tect log|ic error|
|00000550| 73 2c 20 69 6e 20 65 69 | 74 68 65 72 20 79 6f 75 |s, in ei|ther you|
|00000560| 72 20 63 6f 64 65 20 6f | 72 20 69 6e 20 61 20 63 |r code o|r in a c|
|00000570| 6c 69 65 6e 74 20 6f 66 | 20 79 6f 75 72 20 63 6f |lient of| your co|
|00000580| 64 65 2e 20 41 6e 20 61 | 73 73 65 72 74 69 6f 6e |de. An a|ssertion|
|00000590| 20 69 73 20 61 6e 20 69 | 6e 76 6f 63 61 74 69 6f | is an i|nvocatio|
|000005a0| 6e 20 6f 66 20 74 68 65 | 20 4f 50 46 20 6d 61 63 |n of the| OPF mac|
|000005b0| 72 6f 2c 20 46 57 5f 41 | 53 53 45 52 54 2e 20 54 |ro, FW_A|SSERT. T|
|000005c0| 68 69 73 20 6d 61 63 72 | 6f 20 69 73 20 66 75 6e |his macr|o is fun|
|000005d0| 63 74 69 6f 6e 61 6c 6c | 79 20 69 64 65 6e 74 69 |ctionall|y identi|
|000005e0| 63 61 6c 20 74 6f 20 74 | 68 65 20 73 74 61 6e 64 |cal to t|he stand|
|000005f0| 61 72 64 20 43 20 61 73 | 73 65 72 74 28 29 20 6d |ard C as|sert() m|
|00000600| 61 63 72 6f 20 65 78 63 | 65 70 74 20 74 68 61 74 |acro exc|ept that|
|00000610| 2c 20 72 61 74 68 65 72 | 20 74 68 61 6e 20 65 78 |, rather| than ex|
|00000620| 69 74 69 6e 67 20 74 68 | 65 20 70 61 72 74 2c 20 |iting th|e part, |
|00000630| 61 20 66 61 69 6c 65 64 | 20 61 73 73 65 72 74 69 |a failed| asserti|
|00000640| 6f 6e 20 61 63 74 69 76 | 61 74 65 73 20 74 68 65 |on activ|ates the|
|00000650| 20 6c 6f 77 2d 6c 65 76 | 65 6c 20 64 65 62 75 67 | low-lev|el debug|
|00000660| 67 65 72 20 61 74 20 74 | 68 65 20 70 6f 69 6e 74 |ger at t|he point|
|00000670| 20 6f 66 20 66 61 69 6c | 75 72 65 2e 0d 55 73 65 | of fail|ure..Use|
|00000680| 20 61 73 73 65 72 74 69 | 6f 6e 73 20 66 6f 72 20 | asserti|ons for |
|00000690| 64 65 66 65 6e 73 69 76 | 65 20 70 72 6f 67 72 61 |defensiv|e progra|
|000006a0| 6d 6d 69 6e 67 20 70 75 | 72 70 6f 73 65 73 2e 20 |mming pu|rposes. |
|000006b0| 41 73 73 65 72 74 69 6f | 6e 73 20 61 72 65 20 6f |Assertio|ns are o|
|000006c0| 6e 6c 79 20 65 6e 61 62 | 6c 65 64 20 77 68 65 6e |nly enab|led when|
|000006d0| 20 61 20 70 61 72 74 20 | 69 73 20 62 65 69 6e 67 | a part |is being|
|000006e0| 20 74 65 73 74 65 64 2c | 20 70 72 65 63 69 73 65 | tested,| precise|
|000006f0| 6c 79 20 62 65 63 61 75 | 73 65 20 74 68 65 79 20 |ly becau|se they |
|00000700| 61 72 65 20 63 6f 6e 73 | 69 64 65 72 65 64 20 74 |are cons|idered t|
|00000710| 6f 20 62 65 20 61 20 64 | 65 62 75 67 67 69 6e 67 |o be a d|ebugging|
|00000720| 20 74 6f 6f 6c 2e 20 57 | 68 65 6e 20 61 20 70 61 | tool. W|hen a pa|
|00000730| 72 74 20 69 73 20 72 65 | 6c 65 61 73 65 64 2c 20 |rt is re|leased, |
|00000740| 61 73 73 65 72 74 69 6f | 6e 73 20 61 72 65 20 64 |assertio|ns are d|
|00000750| 69 73 61 62 6c 65 64 2e | 20 48 6f 77 65 76 65 72 |isabled.| However|
|00000760| 2c 20 74 68 65 20 61 73 | 73 65 72 74 69 6f 6e 20 |, the as|sertion |
|00000770| 74 65 78 74 20 72 65 6d | 61 69 6e 73 20 69 6e 20 |text rem|ains in |
|00000780| 74 68 65 20 73 6f 75 72 | 63 65 20 63 6f 64 65 20 |the sour|ce code |
|00000790| 61 73 20 64 6f 63 75 6d | 65 6e 74 61 74 69 6f 6e |as docum|entation|
|000007a0| 2c 20 72 65 61 64 79 20 | 74 6f 20 62 65 20 72 65 |, ready |to be re|
|000007b0| 2d 65 6e 61 62 6c 65 64 | 20 77 68 65 6e 20 74 68 |-enabled| when th|
|000007c0| 65 20 69 6d 70 6c 65 6d | 65 6e 74 61 74 69 6f 6e |e implem|entation|
|000007d0| 20 6f 66 20 61 20 63 6c | 61 73 73 20 69 73 20 63 | of a cl|ass is c|
|000007e0| 68 61 6e 67 65 64 20 6f | 72 20 61 20 6e 65 77 20 |hanged o|r a new |
|000007f0| 63 6c 69 65 6e 74 20 69 | 73 20 74 6f 20 62 65 20 |client i|s to be |
|00000800| 74 65 73 74 65 64 2e 0d | 44 65 62 75 67 20 43 6f |tested..|Debug Co|
|00000810| 6d 70 6f 6e 65 6e 74 20 | 64 65 73 69 67 6e 0d 54 |mponent |design.T|
|00000820| 68 65 20 44 65 62 75 67 | 20 43 6f 6d 70 6f 6e 65 |he Debug| Compone|
|00000830| 6e 74 20 77 61 73 20 64 | 65 73 69 67 6e 65 64 20 |nt was d|esigned |
|00000840| 74 6f 20 6d 65 65 74 20 | 74 68 65 20 66 6f 6c 6c |to meet |the foll|
|00000850| 6f 77 69 6e 67 20 67 6f | 61 6c 73 3a 0d a5 09 44 |owing go|als:...D|
|00000860| 65 66 65 6e 73 69 76 65 | 20 70 72 6f 67 72 61 6d |efensive| program|
|00000870| 6d 69 6e 67 2e 20 54 68 | 65 20 44 65 62 75 67 20 |ming. Th|e Debug |
|00000880| 43 6f 6d 70 6f 6e 65 6e | 74 20 73 75 70 70 6f 72 |Componen|t suppor|
|00000890| 74 73 20 64 65 66 65 6e | 73 69 76 65 20 70 72 6f |ts defen|sive pro|
|000008a0| 67 72 61 6d 6d 69 6e 67 | 20 74 65 63 68 6e 69 71 |gramming| techniq|
|000008b0| 75 65 73 20 74 68 61 74 | 20 61 6c 6c 6f 77 20 79 |ues that| allow y|
|000008c0| 6f 75 20 74 68 65 20 66 | 6c 65 78 69 62 69 6c 69 |ou the f|lexibili|
|000008d0| 74 79 20 74 6f 20 64 65 | 74 65 72 6d 69 6e 65 20 |ty to de|termine |
|000008e0| 68 6f 77 20 74 68 6f 73 | 65 20 74 65 63 68 6e 69 |how thos|e techni|
|000008f0| 71 75 65 73 20 6d 61 6e | 69 66 65 73 74 20 74 68 |ques man|ifest th|
|00000900| 65 6d 73 65 6c 76 65 73 | 2e 20 46 6f 72 20 65 78 |emselves|. For ex|
|00000910| 61 6d 70 6c 65 2c 20 46 | 57 5f 43 44 65 62 75 67 |ample, F|W_CDebug|
|00000920| 43 6f 6e 73 6f 6c 65 20 | 70 72 6f 76 69 64 65 73 |Console |provides|
|00000930| 20 61 6e 20 61 62 73 74 | 72 61 63 74 69 6f 6e 20 | an abst|raction |
|00000940| 66 6f 72 20 6f 75 74 70 | 75 74 74 69 6e 67 20 64 |for outp|utting d|
|00000950| 65 62 75 67 20 69 6e 66 | 6f 72 6d 61 74 69 6f 6e |ebug inf|ormation|
|00000960| 20 77 69 74 68 6f 75 74 | 20 69 6d 70 6f 73 69 6e | without| imposin|
|00000970| 67 20 61 20 73 70 65 63 | 69 66 69 63 20 69 6d 70 |g a spec|ific imp|
|00000980| 6c 65 6d 65 6e 74 61 74 | 69 6f 6e 2e 20 59 6f 75 |lementat|ion. You|
|00000990| 20 63 61 6e 20 77 72 69 | 74 65 20 79 6f 75 72 20 | can wri|te your |
|000009a0| 6f 77 6e 20 73 75 62 63 | 6c 61 73 73 20 6f 66 20 |own subc|lass of |
|000009b0| 46 57 5f 43 44 65 62 75 | 67 43 6f 6e 73 6f 6c 65 |FW_CDebu|gConsole|
|000009c0| 20 73 6f 20 74 68 61 74 | 20 64 65 62 75 67 20 69 | so that| debug i|
|000009d0| 6e 66 6f 72 6d 61 74 69 | 6f 6e 20 63 61 6e 20 62 |nformati|on can b|
|000009e0| 65 20 64 69 72 65 63 74 | 65 64 20 74 6f 20 77 68 |e direct|ed to wh|
|000009f0| 65 72 65 76 65 72 20 79 | 6f 75 20 77 6f 75 6c 64 |erever y|ou would|
|00000a00| 20 6c 69 6b 65 2e 0d 55 | 73 69 6e 67 20 74 68 65 | like..U|sing the|
|00000a10| 20 46 57 5f 43 44 65 62 | 75 67 43 6f 6e 73 6f 6c | FW_CDeb|ugConsol|
|00000a20| 65 20 69 6e 74 65 72 66 | 61 63 65 2c 20 74 68 65 |e interf|ace, the|
|00000a30| 20 44 65 62 75 67 20 43 | 6f 6d 70 6f 6e 65 6e 74 | Debug C|omponent|
|00000a40| 20 70 72 6f 76 69 64 65 | 73 20 61 20 73 65 74 20 | provide|s a set |
|00000a50| 6f 66 20 6d 61 63 72 6f | 73 20 74 68 61 74 20 61 |of macro|s that a|
|00000a60| 6c 6c 6f 77 20 79 6f 75 | 20 74 6f 20 63 6f 6e 64 |llow you| to cond|
|00000a70| 69 74 69 6f 6e 61 6c 6c | 79 20 69 6e 63 6c 75 64 |itionall|y includ|
|00000a80| 65 20 64 65 62 75 67 20 | 63 6f 64 65 20 69 6e 20 |e debug |code in |
|00000a90| 79 6f 75 72 20 70 61 72 | 74 20 74 68 61 74 20 69 |your par|t that i|
|00000aa0| 73 20 70 72 65 73 65 6e | 74 20 77 68 65 6e 20 74 |s presen|t when t|
|00000ab0| 68 65 20 46 57 5f 44 45 | 42 55 47 20 70 72 65 70 |he FW_DE|BUG prep|
|00000ac0| 72 6f 63 65 73 73 6f 72 | 20 66 6c 61 67 20 69 73 |rocessor| flag is|
|00000ad0| 20 64 65 66 69 6e 65 64 | 2e 0d 41 64 64 69 74 69 | defined|..Additi|
|00000ae0| 6f 6e 61 6c 20 44 65 62 | 75 67 20 43 6f 6d 70 6f |onal Deb|ug Compo|
|00000af0| 6e 65 6e 74 20 69 6e 74 | 65 72 66 61 63 65 73 0d |nent int|erfaces.|
|00000b00| 54 68 65 20 66 6f 6c 6c | 6f 77 69 6e 67 20 6d 61 |The foll|owing ma|
|00000b10| 63 72 6f 73 20 61 72 65 | 20 64 65 66 69 6e 65 64 |cros are| defined|
|00000b20| 20 69 6e 20 74 68 65 20 | 44 65 62 75 67 20 43 6f | in the |Debug Co|
|00000b30| 6d 70 6f 6e 65 6e 74 3a | 0d a5 09 46 57 5f 41 53 |mponent:|...FW_AS|
|00000b40| 53 45 52 54 0d a5 09 46 | 57 5f 44 45 42 55 47 47 |SERT...F|W_DEBUGG|
|00000b50| 45 52 0d a5 09 46 57 5f | 44 45 42 55 47 5f 4d 45 |ER...FW_|DEBUG_ME|
|00000b60| 53 53 41 47 45 0d a5 09 | 46 57 5f 4c 4f 47 5f 4d |SSAGE...|FW_LOG_M|
|00000b70| 45 53 53 41 47 45 0d a5 | 09 46 57 5f 50 52 49 56 |ESSAGE..|.FW_PRIV|
|00000b80| 5f 41 53 53 45 52 54 0d | a5 09 46 57 5f 50 52 49 |_ASSERT.|..FW_PRI|
|00000b90| 56 5f 44 45 42 55 47 47 | 45 52 5f 42 52 45 41 4b |V_DEBUGG|ER_BREAK|
|00000ba0| 28 29 0d a5 09 46 57 5f | 50 52 49 56 5f 44 45 42 |()...FW_|PRIV_DEB|
|00000bb0| 55 47 47 45 52 5f 53 54 | 52 49 4e 47 0d 54 68 65 |UGGER_ST|RING.The|
|00000bc0| 20 66 69 72 73 74 20 66 | 6f 75 72 20 61 72 65 20 | first f|our are |
|00000bd0| 69 6e 74 65 6e 64 65 64 | 20 66 6f 72 20 75 73 65 |intended| for use|
|00000be0| 20 62 79 20 4f 50 46 20 | 70 61 72 74 20 64 65 76 | by OPF |part dev|
|00000bf0| 65 6c 6f 70 65 72 73 2e | 20 54 68 65 20 65 78 61 |elopers.| The exa|
|00000c00| 63 74 20 62 65 68 61 76 | 69 6f 72 20 6f 66 20 74 |ct behav|ior of t|
|00000c10| 68 65 73 65 20 66 6f 75 | 72 20 6d 61 63 72 6f 73 |hese fou|r macros|
|00000c20| 20 69 73 20 64 65 74 65 | 72 6d 69 6e 65 64 20 62 | is dete|rmined b|
|00000c30| 79 20 74 68 65 20 69 6e | 73 74 61 6c 6c 65 64 20 |y the in|stalled |
|00000c40| 64 65 62 75 67 20 63 6f | 6e 73 6f 6c 65 2c 20 77 |debug co|nsole, w|
|00000c50| 68 69 63 68 20 6d 65 61 | 6e 73 20 74 68 61 74 20 |hich mea|ns that |
|00000c60| 79 6f 75 20 63 61 6e 20 | 72 65 64 65 66 69 6e 65 |you can |redefine|
|00000c70| 20 74 68 65 20 62 65 68 | 61 76 69 6f 72 20 74 6f | the beh|avior to|
|00000c80| 20 73 75 69 74 20 79 6f | 75 72 20 6e 65 65 64 73 | suit yo|ur needs|
|00000c90| 2e 20 48 6f 77 65 76 65 | 72 2c 20 74 68 65 20 69 |. Howeve|r, the i|
|00000ca0| 6e 74 65 6e 64 65 64 20 | 62 65 68 61 76 69 6f 72 |ntended |behavior|
|00000cb0| 20 69 73 20 61 73 20 66 | 6f 6c 6c 6f 77 73 3a 0d | is as f|ollows:.|
|00000cc0| a5 09 54 68 65 20 46 57 | 5f 41 53 53 45 52 54 20 |..The FW|_ASSERT |
|00000cd0| 6d 61 63 72 6f 20 6d 65 | 61 6e 73 20 d2 49 66 20 |macro me|ans .If |
|00000ce0| 74 68 65 20 65 78 70 72 | 65 73 73 69 6f 6e 20 65 |the expr|ession e|
|00000cf0| 76 61 6c 75 61 74 65 73 | 20 74 6f 20 66 61 6c 73 |valuates| to fals|
|00000d00| 65 2c 20 64 72 6f 70 20 | 69 6e 74 6f 20 74 68 65 |e, drop |into the|
|00000d10| 20 6c 6f 77 2d 6c 65 76 | 65 6c 20 64 65 62 75 67 | low-lev|el debug|
|00000d20| 67 65 72 20 61 6e 64 20 | 64 69 73 70 6c 61 79 20 |ger and |display |
|00000d30| 74 68 65 20 65 78 70 72 | 65 73 73 69 6f 6e 20 61 |the expr|ession a|
|00000d40| 73 20 73 74 72 69 6e 67 | 2e d3 0d a5 09 54 68 65 |s string|.....The|
|00000d50| 20 46 57 5f 44 45 42 55 | 47 47 45 52 20 6d 61 63 | FW_DEBU|GGER mac|
|00000d60| 72 6f 20 6d 65 61 6e 73 | 20 d2 53 75 73 70 65 6e |ro means| .Suspen|
|00000d70| 64 20 6e 6f 72 6d 61 6c | 20 65 78 65 63 75 74 69 |d normal| executi|
|00000d80| 6f 6e 20 62 79 20 64 72 | 6f 70 70 69 6e 67 20 69 |on by dr|opping i|
|00000d90| 6e 74 6f 20 74 68 65 20 | 6c 6f 77 2d 6c 65 76 65 |nto the |low-leve|
|00000da0| 6c 20 64 65 62 75 67 67 | 65 72 20 77 69 74 68 6f |l debugg|er witho|
|00000db0| 75 74 20 64 69 73 70 6c | 61 79 69 6e 67 20 61 20 |ut displ|aying a |
|00000dc0| 6d 65 73 73 61 67 65 2e | d3 0d a5 09 54 68 65 20 |message.|....The |
|00000dd0| 46 57 5f 44 45 42 55 47 | 5f 4d 45 53 53 41 47 45 |FW_DEBUG|_MESSAGE|
|00000de0| 20 6d 61 63 72 6f 20 6d | 65 61 6e 73 20 d2 53 75 | macro m|eans .Su|
|00000df0| 73 70 65 6e 64 20 6e 6f | 72 6d 61 6c 20 65 78 65 |spend no|rmal exe|
|00000e00| 63 75 74 69 6f 6e 20 62 | 79 20 64 72 6f 70 70 69 |cution b|y droppi|
|00000e10| 6e 67 20 69 6e 74 6f 20 | 74 68 65 20 6c 6f 77 2d |ng into |the low-|
|00000e20| 6c 65 76 65 6c 20 64 65 | 62 75 67 67 65 72 20 61 |level de|bugger a|
|00000e30| 6e 64 20 64 69 73 70 6c | 61 79 20 74 68 65 20 67 |nd displ|ay the g|
|00000e40| 69 76 65 6e 20 6d 65 73 | 73 61 67 65 2e d3 0d a5 |iven mes|sage....|
|00000e50| 09 54 68 65 20 46 57 5f | 4c 4f 47 5f 4d 45 53 53 |.The FW_|LOG_MESS|
|00000e60| 41 47 45 20 6d 61 63 72 | 6f 20 6d 65 61 6e 73 20 |AGE macr|o means |
|00000e70| d2 44 69 73 70 6c 61 79 | 20 74 68 65 20 6d 65 73 |.Display| the mes|
|00000e80| 73 61 67 65 2c 20 70 72 | 65 66 65 72 61 62 6c 79 |sage, pr|eferably|
|00000e90| 20 77 69 74 68 6f 75 74 | 20 73 75 73 70 65 6e 64 | without| suspend|
|00000ea0| 69 6e 67 20 65 78 65 63 | 75 74 69 6f 6e 2e d3 0d |ing exec|ution...|
|00000eb0| 54 68 65 20 6f 74 68 65 | 72 20 74 68 72 65 65 20 |The othe|r three |
|00000ec0| 6d 61 63 72 6f 73 20 61 | 72 65 20 69 6e 74 65 72 |macros a|re inter|
|00000ed0| 6e 61 6c 20 6d 61 63 72 | 6f 73 20 74 68 61 74 20 |nal macr|os that |
|00000ee0| 61 72 65 20 6e 6f 72 6d | 61 6c 6c 79 20 6e 6f 74 |are norm|ally not|
|00000ef0| 20 75 73 65 64 20 62 79 | 20 4f 50 46 20 70 61 72 | used by| OPF par|
|00000f00| 74 20 64 65 76 65 6c 6f | 70 65 72 73 2e 20 54 68 |t develo|pers. Th|
|00000f10| 65 73 65 20 74 68 72 65 | 65 20 6d 61 63 72 6f 73 |ese thre|e macros|
|00000f20| 20 68 61 76 65 20 73 69 | 6d 69 6c 61 72 20 62 65 | have si|milar be|
|00000f30| 68 61 76 69 6f 72 20 74 | 6f 20 74 68 65 20 46 57 |havior t|o the FW|
|00000f40| 5f 41 53 53 45 52 54 2c | 20 46 57 5f 44 45 42 55 |_ASSERT,| FW_DEBU|
|00000f50| 47 47 45 52 2c 20 61 6e | 64 20 46 57 5f 44 45 42 |GGER, an|d FW_DEB|
|00000f60| 55 47 5f 4d 45 53 53 41 | 47 45 20 6d 61 63 72 6f |UG_MESSA|GE macro|
|00000f70| 73 2c 20 62 75 74 20 74 | 68 65 69 72 20 62 65 68 |s, but t|heir beh|
|00000f80| 61 76 69 6f 72 20 69 73 | 20 6e 6f 74 20 63 68 61 |avior is| not cha|
|00000f90| 6e 67 65 64 20 62 79 20 | 69 6e 73 74 61 6c 6c 69 |nged by |installi|
|00000fa0| 6e 67 20 61 20 64 69 66 | 66 65 72 65 6e 74 20 64 |ng a dif|ferent d|
|00000fb0| 65 62 75 67 20 63 6f 6e | 73 6f 6c 65 2e 20 54 68 |ebug con|sole. Th|
|00000fc0| 65 20 64 65 66 61 75 6c | 74 20 62 65 68 61 76 69 |e defaul|t behavi|
|00000fd0| 6f 72 20 66 6f 72 20 74 | 68 65 73 65 20 73 65 72 |or for t|hese ser|
|00000fe0| 76 69 63 65 73 20 69 73 | 20 69 6d 70 6c 65 6d 65 |vices is| impleme|
|00000ff0| 6e 74 65 64 20 69 6e 20 | 74 65 72 6d 73 20 6f 66 |nted in |terms of|
|00001000| 20 74 68 65 20 64 6f 63 | 75 6d 65 6e 74 65 64 20 | the doc|umented |
|00001010| 4d 61 63 69 6e 74 6f 73 | 68 20 61 6e 64 20 57 69 |Macintos|h and Wi|
|00001020| 6e 64 6f 77 73 20 6f 70 | 65 72 61 74 69 6e 67 20 |ndows op|erating |
|00001030| 73 79 73 74 65 6d 20 63 | 61 6c 6c 73 20 66 6f 72 |system c|alls for|
|00001040| 20 64 72 6f 70 70 69 6e | 67 20 69 6e 74 6f 20 74 | droppin|g into t|
|00001050| 68 65 20 6c 6f 77 2d 6c | 65 76 65 6c 20 64 65 62 |he low-l|evel deb|
|00001060| 75 67 67 65 72 2e 20 49 | 66 20 79 6f 75 20 77 61 |ugger. I|f you wa|
|00001070| 6e 74 20 74 6f 20 67 75 | 61 72 61 6e 74 65 65 20 |nt to gu|arantee |
|00001080| 74 68 61 74 20 61 6e 20 | 61 73 73 65 72 74 69 6f |that an |assertio|
|00001090| 6e 20 6f 72 20 64 65 62 | 75 67 20 6d 65 73 73 61 |n or deb|ug messa|
|000010a0| 67 65 20 69 73 20 64 69 | 73 70 6c 61 79 65 64 20 |ge is di|splayed |
|000010b0| 69 6e 20 74 68 65 20 6c | 6f 77 2d 6c 65 76 65 6c |in the l|ow-level|
|000010c0| 20 64 65 62 75 67 67 65 | 72 20 69 6e 73 74 65 61 | debugge|r instea|
|000010d0| 64 20 6f 66 20 74 68 65 | 20 69 6e 73 74 61 6c 6c |d of the| install|
|000010e0| 65 64 20 64 65 62 75 67 | 20 63 6f 6e 73 6f 6c 65 |ed debug| console|
|000010f0| 2c 20 74 68 65 6e 20 79 | 6f 75 20 73 68 6f 75 6c |, then y|ou shoul|
|00001100| 64 20 75 73 65 20 74 68 | 65 73 65 20 6d 61 63 72 |d use th|ese macr|
|00001110| 6f 73 2e 0d 43 6f 6d 70 | 6f 6e 65 6e 74 20 64 65 |os..Comp|onent de|
|00001120| 70 65 6e 64 65 6e 63 69 | 65 73 0d 41 6c 6c 20 4f |pendenci|es.All O|
|00001130| 50 46 20 63 6f 6d 70 6f | 6e 65 6e 74 73 20 75 73 |PF compo|nents us|
|00001140| 65 20 74 68 65 20 64 65 | 62 75 67 20 74 6f 6f 6c |e the de|bug tool|
|00001150| 73 20 70 72 6f 76 69 64 | 65 64 20 62 79 20 74 68 |s provid|ed by th|
|00001160| 65 20 44 65 62 75 67 20 | 43 6f 6d 70 6f 6e 65 6e |e Debug |Componen|
|00001170| 74 2e 20 48 6f 77 65 76 | 65 72 2c 20 77 68 65 6e |t. Howev|er, when|
|00001180| 20 4f 50 46 20 69 73 20 | 62 75 69 6c 74 20 77 69 | OPF is |built wi|
|00001190| 74 68 20 74 68 65 20 46 | 57 5f 44 45 42 55 47 20 |th the F|W_DEBUG |
|000011a0| 70 72 65 70 72 6f 63 65 | 73 73 6f 72 20 66 6c 61 |preproce|ssor fla|
|000011b0| 67 20 75 6e 64 65 66 69 | 6e 65 64 2c 20 74 68 65 |g undefi|ned, the|
|000011c0| 6e 20 6e 6f 20 4f 50 46 | 20 63 6f 6d 70 6f 6e 65 |n no OPF| compone|
|000011d0| 6e 74 73 20 75 73 65 20 | 74 68 69 73 20 63 6f 6d |nts use |this com|
|000011e0| 70 6f 6e 65 6e 74 2e 20 | 54 68 65 20 44 65 62 75 |ponent. |The Debu|
|000011f0| 67 20 43 6f 6d 70 6f 6e | 65 6e 74 20 69 73 20 6f |g Compon|ent is o|
|00001200| 6e 6c 79 20 6e 65 63 65 | 73 73 61 72 79 20 64 75 |nly nece|ssary du|
|00001210| 72 69 6e 67 20 70 61 72 | 74 20 74 65 73 74 69 6e |ring par|t testin|
|00001220| 67 3b 20 72 65 6c 65 61 | 73 65 20 62 75 69 6c 64 |g; relea|se build|
|00001230| 73 20 64 6f 20 6e 6f 74 | 20 64 65 70 65 6e 64 20 |s do not| depend |
|00001240| 6f 6e 20 74 68 65 20 44 | 65 62 75 67 20 43 6f 6d |on the D|ebug Com|
|00001250| 70 6f 6e 65 6e 74 2e 0d | 55 73 69 6e 67 20 74 68 |ponent..|Using th|
|00001260| 65 20 44 65 62 75 67 20 | 43 6f 6d 70 6f 6e 65 6e |e Debug |Componen|
|00001270| 74 0d 47 65 6e 65 72 61 | 6c 6c 79 2c 20 75 73 65 |t.Genera|lly, use|
|00001280| 20 74 68 65 20 44 65 62 | 75 67 20 43 6f 6d 70 6f | the Deb|ug Compo|
|00001290| 6e 65 6e 74 20 63 6c 61 | 73 73 65 73 20 64 75 72 |nent cla|sses dur|
|000012a0| 69 6e 67 20 74 68 65 20 | 74 65 73 74 69 6e 67 20 |ing the |testing |
|000012b0| 61 6e 64 20 64 65 62 75 | 67 67 69 6e 67 20 6f 66 |and debu|gging of|
|000012c0| 20 4f 50 46 20 70 61 72 | 74 73 2e 20 53 70 65 63 | OPF par|ts. Spec|
|000012d0| 69 66 69 63 61 6c 6c 79 | 3a 0d a5 09 57 72 69 74 |ifically|:...Writ|
|000012e0| 65 20 64 65 62 75 67 20 | 6d 65 73 73 61 67 65 73 |e debug |messages|
|000012f0| 20 74 6f 20 61 20 64 65 | 62 75 67 20 63 6f 6e 73 | to a de|bug cons|
|00001300| 6f 6c 65 20 61 6e 64 20 | 62 72 65 61 6b 2d 70 6f |ole and |break-po|
|00001310| 69 6e 74 20 69 6e 74 6f | 20 74 68 65 20 6c 6f 77 |int into| the low|
|00001320| 2d 6c 65 76 65 6c 20 64 | 65 62 75 67 67 65 72 2e |-level d|ebugger.|
|00001330| 0d a5 09 4f 75 74 70 75 | 74 20 66 75 6e 64 61 6d |...Outpu|t fundam|
|00001340| 65 6e 74 61 6c 20 74 79 | 70 65 73 2c 20 70 6f 69 |ental ty|pes, poi|
|00001350| 6e 74 65 72 73 2c 20 61 | 6e 64 20 6e 75 6c 6c 2d |nters, a|nd null-|
|00001360| 74 65 72 6d 69 6e 61 74 | 65 64 20 73 74 72 69 6e |terminat|ed strin|
|00001370| 67 73 20 74 6f 20 61 20 | 64 65 62 75 67 20 73 74 |gs to a |debug st|
|00001380| 72 65 61 6d 2e 0d a5 09 | 43 72 65 61 74 65 20 6d |ream....|Create m|
|00001390| 65 6d 6f 72 79 20 64 65 | 62 75 67 20 73 74 72 65 |emory de|bug stre|
|000013a0| 61 6d 73 2e 0d a5 09 43 | 72 65 61 74 65 20 66 69 |ams....C|reate fi|
|000013b0| 6c 65 20 64 65 62 75 67 | 20 73 74 72 65 61 6d 73 |le debug| streams|
|000013c0| 2e 0d a5 09 43 72 65 61 | 74 65 20 6e 75 6c 6c 20 |....Crea|te null |
|000013d0| 64 65 62 75 67 20 73 74 | 72 65 61 6d 73 2e 0d a5 |debug st|reams...|
|000013e0| 09 50 72 6f 76 69 64 65 | 20 66 75 6e 63 74 69 6f |.Provide| functio|
|000013f0| 6e 20 74 72 61 63 69 6e | 67 20 63 61 70 61 62 69 |n tracin|g capabi|
|00001400| 6c 69 74 69 65 73 2e 0d | 53 75 62 63 6c 61 73 73 |lities..|Subclass|
|00001410| 69 6e 67 20 77 69 74 68 | 69 6e 20 74 68 65 20 44 |ing with|in the D|
|00001420| 65 62 75 67 20 43 6f 6d | 70 6f 6e 65 6e 74 0d 59 |ebug Com|ponent.Y|
|00001430| 6f 75 20 63 61 6e 20 63 | 72 65 61 74 65 20 79 6f |ou can c|reate yo|
|00001440| 75 72 20 6f 77 6e 20 73 | 75 62 63 6c 61 73 73 65 |ur own s|ubclasse|
|00001450| 73 20 6f 66 20 46 57 5f | 43 44 65 62 75 67 43 6f |s of FW_|CDebugCo|
|00001460| 6e 73 6f 6c 65 20 6f 72 | 20 46 57 5f 43 44 65 62 |nsole or| FW_CDeb|
|00001470| 75 67 53 74 72 65 61 6d | 2c 20 69 66 20 79 6f 75 |ugStream|, if you|
|00001480| 20 77 61 6e 74 20 74 6f | 20 65 69 74 68 65 72 20 | want to| either |
|00001490| 63 68 61 6e 67 65 20 74 | 68 65 20 62 65 68 61 76 |change t|he behav|
|000014a0| 69 6f 72 20 6f 66 20 74 | 68 65 20 64 65 62 75 67 |ior of t|he debug|
|000014b0| 67 69 6e 67 20 61 63 74 | 69 6f 6e 73 20 6f 72 20 |ging act|ions or |
|000014c0| 70 72 6f 76 69 64 65 20 | 61 20 63 6f 6e 63 72 65 |provide |a concre|
|000014d0| 74 65 20 64 65 62 75 67 | 20 73 74 72 65 61 6d 20 |te debug| stream |
|000014e0| 74 68 61 74 20 73 65 6e | 64 73 20 69 74 73 20 6f |that sen|ds its o|
|000014f0| 75 74 70 75 74 20 74 6f | 20 73 6f 6d 65 20 6c 6f |utput to| some lo|
|00001500| 63 61 74 69 6f 6e 2e 0d | 49 6e 73 74 61 6e 74 69 |cation..|Instanti|
|00001510| 61 74 69 6e 67 20 77 69 | 74 68 69 6e 20 74 68 65 |ating wi|thin the|
|00001520| 20 44 65 62 75 67 20 43 | 6f 6d 70 6f 6e 65 6e 74 | Debug C|omponent|
|00001530| 0d 59 6f 75 20 64 6f 20 | 6e 6f 74 20 6e 65 65 64 |.You do |not need|
|00001540| 20 74 6f 20 69 6e 73 74 | 61 6e 74 69 61 74 65 20 | to inst|antiate |
|00001550| 61 6e 79 20 63 6c 61 73 | 73 65 73 20 66 72 6f 6d |any clas|ses from|
|00001560| 20 74 68 65 20 44 65 62 | 75 67 20 43 6f 6d 70 6f | the Deb|ug Compo|
|00001570| 6e 65 6e 74 20 69 66 3a | 0d a5 09 59 6f 75 20 64 |nent if:|...You d|
|00001580| 6f 20 6e 6f 74 20 77 72 | 69 74 65 20 79 6f 75 72 |o not wr|ite your|
|00001590| 20 6f 77 6e 20 73 75 62 | 63 6c 61 73 73 65 73 20 | own sub|classes |
|000015a0| 6f 66 20 46 57 5f 43 44 | 65 62 75 67 43 6f 6e 73 |of FW_CD|ebugCons|
|000015b0| 6f 6c 65 2c 20 61 6e 64 | 0d a5 09 59 6f 75 20 64 |ole, and|...You d|
|000015c0| 6f 20 6e 6f 74 20 75 73 | 65 20 46 57 5f 43 44 65 |o not us|e FW_CDe|
|000015d0| 62 75 67 53 74 72 65 61 | 6d 2e 0d 54 68 69 73 20 |bugStrea|m..This |
|000015e0| 69 73 20 62 65 63 61 75 | 73 65 20 61 6e 20 69 6e |is becau|se an in|
|000015f0| 73 74 61 6e 63 65 20 6f | 66 20 46 57 5f 43 44 65 |stance o|f FW_CDe|
|00001600| 62 75 67 43 6f 6e 73 6f | 6c 65 20 69 73 20 61 75 |bugConso|le is au|
|00001610| 74 6f 6d 61 74 69 63 61 | 6c 6c 79 20 63 72 65 61 |tomatica|lly crea|
|00001620| 74 65 64 20 64 75 72 69 | 6e 67 20 70 61 72 74 20 |ted duri|ng part |
|00001630| 69 6e 69 74 69 61 6c 69 | 7a 61 74 69 6f 6e 20 61 |initiali|zation a|
|00001640| 6e 64 20 46 57 5f 43 54 | 72 61 63 65 52 75 6e 74 |nd FW_CT|raceRunt|
|00001650| 69 6d 65 20 73 68 6f 75 | 6c 64 20 6e 65 76 65 72 |ime shou|ld never|
|00001660| 20 62 65 20 69 6e 73 74 | 61 6e 74 69 61 74 65 64 | be inst|antiated|
|00001670| 2e 20 28 4f 6e 6c 79 20 | 74 68 65 20 63 6c 61 73 |. (Only |the clas|
|00001680| 73 65 73 20 70 72 6f 76 | 69 64 65 64 20 61 73 20 |ses prov|ided as |
|00001690| 73 75 62 63 6c 61 73 73 | 65 73 20 6f 66 20 46 57 |subclass|es of FW|
|000016a0| 5f 43 44 65 62 75 67 53 | 74 72 65 61 6d 20 61 72 |_CDebugS|tream ar|
|000016b0| 65 20 69 6e 73 74 61 6e | 74 69 61 74 65 64 2e 29 |e instan|tiated.)|
|000016c0| 0d 48 6f 77 65 76 65 72 | 2c 20 69 66 20 79 6f 75 |.However|, if you|
|000016d0| 20 63 72 65 61 74 65 20 | 79 6f 75 72 20 6f 77 6e | create |your own|
|000016e0| 20 73 75 62 63 6c 61 73 | 73 20 6f 66 20 46 57 5f | subclas|s of FW_|
|000016f0| 43 44 65 62 75 67 43 6f | 6e 73 6f 6c 65 2c 20 74 |CDebugCo|nsole, t|
|00001700| 68 65 6e 20 79 6f 75 20 | 77 69 6c 6c 20 6e 65 65 |hen you |will nee|
|00001710| 64 20 74 6f 20 63 72 65 | 61 74 65 20 61 6e 20 69 |d to cre|ate an i|
|00001720| 6e 73 74 61 6e 63 65 20 | 61 6e 64 20 69 6e 73 74 |nstance |and inst|
|00001730| 61 6c 6c 20 69 74 20 61 | 73 20 74 68 65 20 64 65 |all it a|s the de|
|00001740| 62 75 67 20 63 6f 6e 73 | 6f 6c 65 20 64 75 72 69 |bug cons|ole duri|
|00001750| 6e 67 20 79 6f 75 72 20 | 70 61 72 74 20 69 6e 69 |ng your |part ini|
|00001760| 74 69 61 6c 69 7a 61 74 | 69 6f 6e 2e 20 46 6f 72 |tializat|ion. For|
|00001770| 20 6d 6f 72 65 20 69 6e | 66 6f 72 6d 61 74 69 6f | more in|formatio|
|00001780| 6e 20 6f 6e 20 73 75 62 | 63 6c 61 73 73 69 6e 67 |n on sub|classing|
|00001790| 20 46 57 5f 43 44 65 62 | 75 67 43 6f 6e 73 6f 6c | FW_CDeb|ugConsol|
|000017a0| 65 2c 20 73 65 65 20 d2 | 53 75 62 63 6c 61 73 73 |e, see .|Subclass|
|000017b0| 69 6e 67 20 46 57 5f 43 | 44 65 62 75 67 43 6f 6e |ing FW_C|DebugCon|
|000017c0| 73 6f 6c 65 d3 20 6f 6e | 20 70 61 67 65 20 38 2e |sole. on| page 8.|
|000017d0| 0d 45 78 74 65 6e 64 69 | 6e 67 20 74 68 65 20 44 |.Extendi|ng the D|
|000017e0| 65 62 75 67 20 43 6f 6d | 70 6f 6e 65 6e 74 0d 59 |ebug Com|ponent.Y|
|000017f0| 6f 75 20 63 61 6e 20 65 | 78 74 65 6e 64 20 74 68 |ou can e|xtend th|
|00001800| 65 20 44 65 62 75 67 20 | 43 6f 6d 70 6f 6e 65 6e |e Debug |Componen|
|00001810| 74 20 62 79 20 77 72 69 | 74 69 6e 67 20 79 6f 75 |t by wri|ting you|
|00001820| 72 20 6f 77 6e 20 73 75 | 62 63 6c 61 73 73 65 73 |r own su|bclasses|
|00001830| 20 6f 66 20 46 57 5f 43 | 44 65 62 75 67 43 6f 6e | of FW_C|DebugCon|
|00001840| 73 6f 6c 65 20 6f 72 20 | 46 57 5f 43 44 65 62 75 |sole or |FW_CDebu|
|00001850| 67 53 74 72 65 61 6d 2e | 0d 43 61 74 63 68 69 6e |gStream.|.Catchin|
|00001860| 67 20 44 65 62 75 67 20 | 43 6f 6d 70 6f 6e 65 6e |g Debug |Componen|
|00001870| 74 20 65 78 63 65 70 74 | 69 6f 6e 73 0d 4d 65 74 |t except|ions.Met|
|00001880| 68 6f 64 73 20 69 6e 20 | 74 68 65 20 44 65 62 75 |hods in |the Debu|
|00001890| 67 20 43 6f 6d 70 6f 6e | 65 6e 74 20 64 6f 20 6e |g Compon|ent do n|
|000018a0| 6f 74 20 74 68 72 6f 77 | 20 65 78 63 65 70 74 69 |ot throw| excepti|
|000018b0| 6f 6e 73 2e 0d 50 6c 61 | 74 66 6f 72 6d 20 64 65 |ons..Pla|tform de|
|000018c0| 70 65 6e 64 65 6e 63 69 | 65 73 20 69 6e 20 74 68 |pendenci|es in th|
|000018d0| 65 20 44 65 62 75 67 20 | 43 6f 6d 70 6f 6e 65 6e |e Debug |Componen|
|000018e0| 74 0d 54 68 65 72 65 20 | 61 72 65 20 61 20 66 65 |t.There |are a fe|
|000018f0| 77 20 70 6c 61 74 66 6f | 72 6d 2d 64 65 70 65 6e |w platfo|rm-depen|
|00001900| 64 65 6e 74 20 6d 65 74 | 68 6f 64 73 20 75 73 65 |dent met|hods use|
|00001910| 64 20 66 6f 72 20 74 72 | 61 63 69 6e 67 2c 20 62 |d for tr|acing, b|
|00001920| 75 74 20 74 68 65 79 20 | 61 72 65 20 61 6c 6c 20 |ut they |are all |
|00001930| 69 6e 74 65 72 6e 61 6c | 20 6d 65 74 68 6f 64 73 |internal| methods|
|00001940| 20 69 6e 74 65 6e 64 65 | 64 20 66 6f 72 20 75 73 | intende|d for us|
|00001950| 65 20 62 79 20 4f 50 46 | 20 6f 6e 6c 79 2e 0d 46 |e by OPF| only..F|
|00001960| 57 5f 43 44 65 62 75 67 | 43 6f 6e 73 6f 6c 65 20 |W_CDebug|Console |
|00001970| 43 6c 61 73 73 0d 49 6e | 74 72 6f 64 75 63 74 69 |Class.In|troducti|
|00001980| 6f 6e 0d 46 57 5f 43 44 | 65 62 75 67 43 6f 6e 73 |on.FW_CD|ebugCons|
|00001990| 6f 6c 65 20 70 72 6f 76 | 69 64 65 73 20 62 61 73 |ole prov|ides bas|
|000019a0| 69 63 20 6c 6f 77 2d 6c | 65 76 65 6c 20 73 65 72 |ic low-l|evel ser|
|000019b0| 76 69 63 65 73 20 66 6f | 72 20 64 65 62 75 67 67 |vices fo|r debugg|
|000019c0| 69 6e 67 2e 20 49 74 20 | 70 72 6f 76 69 64 65 73 |ing. It |provides|
|000019d0| 20 61 6e 20 69 6e 74 65 | 72 66 61 63 65 20 66 6f | an inte|rface fo|
|000019e0| 72 20 77 72 69 74 69 6e | 67 20 64 65 62 75 67 20 |r writin|g debug |
|000019f0| 6d 65 73 73 61 67 65 73 | 20 74 6f 20 61 20 64 65 |messages| to a de|
|00001a00| 62 75 67 20 63 6f 6e 73 | 6f 6c 65 2c 20 61 6e 64 |bug cons|ole, and|
|00001a10| 20 66 6f 72 20 62 72 65 | 61 6b 2d 70 6f 69 6e 74 | for bre|ak-point|
|00001a20| 69 6e 67 20 69 6e 74 6f | 20 74 68 65 20 6c 6f 77 |ing into| the low|
|00001a30| 2d 6c 65 76 65 6c 20 64 | 65 62 75 67 67 65 72 2e |-level d|ebugger.|
|00001a40| 20 54 68 65 20 64 65 66 | 61 75 6c 74 20 62 65 68 | The def|ault beh|
|00001a50| 61 76 69 6f 72 20 66 6f | 72 20 74 68 65 73 65 20 |avior fo|r these |
|00001a60| 73 65 72 76 69 63 65 73 | 20 69 73 20 69 6d 70 6c |services| is impl|
|00001a70| 65 6d 65 6e 74 65 64 20 | 69 6e 20 74 65 72 6d 73 |emented |in terms|
|00001a80| 20 6f 66 20 64 6f 63 75 | 6d 65 6e 74 65 64 20 6f | of docu|mented o|
|00001a90| 70 65 72 61 74 69 6e 67 | 20 73 79 73 74 65 6d 20 |perating| system |
|00001aa0| 63 61 6c 6c 73 20 6f 6e | 20 62 6f 74 68 20 74 68 |calls on| both th|
|00001ab0| 65 20 4d 61 63 69 6e 74 | 6f 73 68 20 61 6e 64 20 |e Macint|osh and |
|00001ac0| 57 69 6e 64 6f 77 73 20 | 70 6c 61 74 66 6f 72 6d |Windows |platform|
|00001ad0| 73 2c 20 62 75 74 20 74 | 68 65 20 64 65 66 61 75 |s, but t|he defau|
|00001ae0| 6c 74 20 62 65 68 61 76 | 69 6f 72 20 63 61 6e 20 |lt behav|ior can |
|00001af0| 62 65 20 6d 6f 64 69 66 | 69 65 64 20 69 66 20 79 |be modif|ied if y|
|00001b00| 6f 75 20 70 72 65 66 65 | 72 20 61 20 64 69 66 66 |ou prefe|r a diff|
|00001b10| 65 72 65 6e 74 20 62 65 | 68 61 76 69 6f 72 2e 20 |erent be|havior. |
|00001b20| 49 6e 20 61 64 64 69 74 | 69 6f 6e 20 74 6f 20 74 |In addit|ion to t|
|00001b30| 68 65 73 65 20 6c 6f 77 | 2d 6c 65 76 65 6c 20 73 |hese low|-level s|
|00001b40| 65 72 76 69 63 65 73 2c | 20 46 57 5f 43 44 65 62 |ervices,| FW_CDeb|
|00001b50| 75 67 43 6f 6e 73 6f 6c | 65 20 70 72 6f 76 69 64 |ugConsol|e provid|
|00001b60| 65 73 20 6f 74 68 65 72 | 20 63 6f 6e 76 65 6e 69 |es other| conveni|
|00001b70| 65 6e 74 20 69 6e 74 65 | 72 66 61 63 65 73 20 69 |ent inte|rfaces i|
|00001b80| 6e 20 74 68 65 20 66 6f | 72 6d 20 6f 66 20 6d 61 |n the fo|rm of ma|
|00001b90| 63 72 6f 73 2e 20 54 68 | 65 73 65 20 6d 61 63 72 |cros. Th|ese macr|
|00001ba0| 6f 73 20 61 72 65 20 64 | 65 66 69 6e 65 64 20 74 |os are d|efined t|
|00001bb0| 6f 20 65 6d 69 74 20 6e | 6f 20 63 6f 64 65 20 66 |o emit n|o code f|
|00001bc0| 6f 72 20 72 65 6c 65 61 | 73 65 20 28 6e 6f 6e 2d |or relea|se (non-|
|00001bd0| 64 65 62 75 67 29 20 62 | 75 69 6c 64 73 2e 0d 59 |debug) b|uilds..Y|
|00001be0| 6f 75 20 6e 6f 72 6d 61 | 6c 6c 79 20 64 6f 20 6e |ou norma|lly do n|
|00001bf0| 6f 74 20 69 6e 73 74 61 | 6e 74 69 61 74 65 20 46 |ot insta|ntiate F|
|00001c00| 57 5f 43 44 65 62 75 67 | 43 6f 6e 73 6f 6c 65 2c |W_CDebug|Console,|
|00001c10| 20 73 69 6e 63 65 20 61 | 6e 20 69 6e 73 74 61 6e | since a|n instan|
|00001c20| 63 65 20 69 73 20 61 75 | 74 6f 6d 61 74 69 63 61 |ce is au|tomatica|
|00001c30| 6c 6c 79 20 63 72 65 61 | 74 65 64 20 64 75 72 69 |lly crea|ted duri|
|00001c40| 6e 67 20 70 61 72 74 20 | 69 6e 69 74 69 61 6c 69 |ng part |initiali|
|00001c50| 7a 61 74 69 6f 6e 2e 0d | 48 65 61 64 65 72 20 66 |zation..|Header f|
|00001c60| 69 6c 65 0d 46 57 50 72 | 69 44 65 62 2e 68 0d 48 |ile.FWPr|iDeb.h.H|
|00001c70| 65 72 69 74 61 67 65 0d | 46 57 5f 43 44 65 62 75 |eritage.|FW_CDebu|
|00001c80| 67 43 6f 6e 73 6f 6c 65 | 0d 46 57 5f 43 44 65 62 |gConsole|.FW_CDeb|
|00001c90| 75 67 53 74 72 65 61 6d | 09 31 31 0d a5 20 46 57 |ugStream|.11.. FW|
|00001ca0| 5f 43 42 75 66 66 65 72 | 44 65 62 75 67 53 74 72 |_CBuffer|DebugStr|
|00001cb0| 65 61 6d 09 31 35 0d a5 | 20 46 57 5f 43 46 69 6c |eam.15..| FW_CFil|
|00001cc0| 65 44 65 62 75 67 53 74 | 72 65 61 6d 09 31 37 0d |eDebugSt|ream.17.|
|00001cd0| a5 20 46 57 5f 43 4e 75 | 6c 6c 44 65 62 75 67 53 |. FW_CNu|llDebugS|
|00001ce0| 74 72 65 61 6d 09 31 39 | 0d 46 57 5f 43 54 72 61 |tream.19|.FW_CTra|
|00001cf0| 63 65 52 75 6e 74 69 6d | 65 09 32 31 0d 55 73 69 |ceRuntim|e.21.Usi|
|00001d00| 6e 67 20 46 57 5f 43 44 | 65 62 75 67 43 6f 6e 73 |ng FW_CD|ebugCons|
|00001d10| 6f 6c 65 0d 55 73 65 20 | 46 57 5f 43 44 65 62 75 |ole.Use |FW_CDebu|
|00001d20| 67 43 6f 6e 73 6f 6c 65 | 20 74 68 72 6f 75 67 68 |gConsole| through|
|00001d30| 20 74 68 65 20 6d 61 63 | 72 6f 73 20 46 57 5f 41 | the mac|ros FW_A|
|00001d40| 53 53 45 52 54 2c 20 46 | 57 5f 44 45 42 55 47 47 |SSERT, F|W_DEBUGG|
|00001d50| 45 52 2c 20 46 57 5f 44 | 45 42 55 47 5f 4d 45 53 |ER, FW_D|EBUG_MES|
|00001d60| 53 41 47 45 2c 20 61 6e | 64 20 46 57 5f 4c 4f 47 |SAGE, an|d FW_LOG|
|00001d70| 5f 4d 45 53 53 41 47 45 | 2e 0d 49 6e 20 64 65 62 |_MESSAGE|..In deb|
|00001d80| 75 67 20 62 75 69 6c 64 | 73 2c 20 74 68 65 73 65 |ug build|s, these|
|00001d90| 20 6d 61 63 72 6f 73 20 | 61 72 65 20 74 72 61 6e | macros |are tran|
|00001da0| 73 6c 61 74 65 64 20 74 | 6f 20 75 73 65 20 74 68 |slated t|o use th|
|00001db0| 65 20 73 74 61 74 69 63 | 20 6d 65 74 68 6f 64 73 |e static| methods|
|00001dc0| 20 46 57 5f 43 44 65 62 | 75 67 43 6f 6e 73 6f 6c | FW_CDeb|ugConsol|
|00001dd0| 65 3a 3a 44 65 62 75 67 | 67 65 72 28 29 2c 20 46 |e::Debug|ger(), F|
|00001de0| 57 5f 43 44 65 62 75 67 | 43 6f 6e 73 6f 6c 65 3a |W_CDebug|Console:|
|00001df0| 3a 44 65 62 75 67 4d 65 | 73 73 61 67 65 28 29 2c |:DebugMe|ssage(),|
|00001e00| 20 61 6e 64 20 46 57 5f | 43 44 65 62 75 67 43 6f | and FW_|CDebugCo|
|00001e10| 6e 73 6f 6c 65 3a 3a 4c | 6f 67 4d 65 73 73 61 67 |nsole::L|ogMessag|
|00001e20| 65 28 29 2e 20 54 68 65 | 73 65 20 73 74 61 74 69 |e(). The|se stati|
|00001e30| 63 20 6d 65 74 68 6f 64 | 73 20 69 6e 20 74 75 72 |c method|s in tur|
|00001e40| 6e 20 66 6f 72 77 61 72 | 64 20 74 68 65 20 72 65 |n forwar|d the re|
|00001e50| 71 75 65 73 74 73 20 74 | 6f 20 74 68 65 20 63 75 |quests t|o the cu|
|00001e60| 72 72 65 6e 74 6c 79 20 | 69 6e 73 74 61 6c 6c 65 |rrently |installe|
|00001e70| 64 20 46 57 5f 43 44 65 | 62 75 67 43 6f 6e 73 6f |d FW_CDe|bugConso|
|00001e80| 6c 65 20 74 68 72 6f 75 | 67 68 20 74 68 65 20 76 |le throu|gh the v|
|00001e90| 69 72 74 75 61 6c 20 6d | 65 74 68 6f 64 73 20 44 |irtual m|ethods D|
|00001ea0| 6f 44 65 62 75 67 67 65 | 72 28 29 2c 20 44 6f 44 |oDebugge|r(), DoD|
|00001eb0| 65 62 75 67 4d 65 73 73 | 61 67 65 28 29 2c 20 61 |ebugMess|age(), a|
|00001ec0| 6e 64 20 44 6f 4c 6f 67 | 4d 65 73 73 61 67 65 28 |nd DoLog|Message(|
|00001ed0| 29 2e 0d 49 6e 20 6e 6f | 6e 2d 64 65 62 75 67 20 |)..In no|n-debug |
|00001ee0| 62 75 69 6c 64 73 2c 20 | 74 68 65 20 6d 61 63 72 |builds, |the macr|
|00001ef0| 6f 73 20 65 78 70 61 6e | 64 20 74 6f 20 6e 6f 74 |os expan|d to not|
|00001f00| 68 69 6e 67 2c 20 73 6f | 20 79 6f 75 72 20 64 65 |hing, so| your de|
|00001f10| 62 75 67 20 63 6f 64 65 | 20 69 73 20 61 75 74 6f |bug code| is auto|
|00001f20| 6d 61 74 69 63 61 6c 6c | 79 20 72 65 6d 6f 76 65 |maticall|y remove|
|00001f30| 64 20 66 72 6f 6d 20 79 | 6f 75 72 20 72 65 6c 65 |d from y|our rele|
|00001f40| 61 73 65 20 62 75 69 6c | 64 2e 0d 4e 6f 20 6f 74 |ase buil|d..No ot|
|00001f50| 68 65 72 20 61 63 74 69 | 6f 6e 73 20 61 72 65 20 |her acti|ons are |
|00001f60| 6e 65 63 65 73 73 61 72 | 79 20 74 6f 20 75 73 65 |necessar|y to use|
|00001f70| 20 74 68 69 73 20 63 6c | 61 73 73 2e 0d 46 57 5f | this cl|ass..FW_|
|00001f80| 43 44 65 62 75 67 43 6f | 6e 73 6f 6c 65 20 73 75 |CDebugCo|nsole su|
|00001f90| 62 63 6c 61 73 73 65 73 | 0d 54 68 65 72 65 20 61 |bclasses|.There a|
|00001fa0| 72 65 20 6e 6f 20 73 75 | 62 63 6c 61 73 73 65 73 |re no su|bclasses|
|00001fb0| 20 6f 66 20 74 68 69 73 | 20 63 6c 61 73 73 2e 0d | of this| class..|
|00001fc0| 52 65 6c 61 74 65 64 20 | 63 6c 61 73 73 65 73 0d |Related |classes.|
|00001fd0| 46 57 5f 43 44 65 62 75 | 67 43 6f 6e 73 6f 6c 65 |FW_CDebu|gConsole|
|00001fe0| 20 69 73 20 61 20 63 6f | 6e 74 61 69 6e 65 72 20 | is a co|ntainer |
|00001ff0| 66 6f 72 20 46 57 5f 43 | 44 65 62 75 67 53 74 72 |for FW_C|DebugStr|
|00002000| 65 61 6d 2e 20 46 57 5f | 43 44 65 62 75 67 43 6f |eam. FW_|CDebugCo|
|00002010| 6e 73 6f 6c 65 20 63 6f | 6e 74 61 69 6e 73 20 46 |nsole co|ntains F|
|00002020| 57 5f 43 44 65 62 75 67 | 53 74 72 65 61 6d 20 66 |W_CDebug|Stream f|
|00002030| 69 65 6c 64 73 20 61 6e | 64 20 69 6e 74 65 72 66 |ields an|d interf|
|00002040| 61 63 65 73 20 66 6f 72 | 20 61 63 63 65 73 73 69 |aces for| accessi|
|00002050| 6e 67 20 74 68 6f 73 65 | 20 66 69 65 6c 64 73 20 |ng those| fields |
|00002060| 28 74 68 65 20 66 69 65 | 6c 64 73 20 61 72 65 20 |(the fie|lds are |
|00002070| 63 75 72 72 65 6e 74 6c | 79 20 6e 6f 74 20 75 73 |currentl|y not us|
|00002080| 65 64 29 2e 20 49 66 20 | 79 6f 75 20 75 73 65 20 |ed). If |you use |
|00002090| 64 65 62 75 67 20 73 74 | 72 65 61 6d 73 20 69 6e |debug st|reams in|
|000020a0| 20 79 6f 75 72 20 70 61 | 72 74 2c 20 74 68 65 6e | your pa|rt, then|
|000020b0| 20 79 6f 75 20 6d 69 67 | 68 74 20 77 61 6e 74 20 | you mig|ht want |
|000020c0| 74 6f 20 75 73 65 20 46 | 57 5f 43 44 65 62 75 67 |to use F|W_CDebug|
|000020d0| 43 6f 6e 73 6f 6c 65 20 | 74 6f 20 61 63 63 65 73 |Console |to acces|
|000020e0| 73 20 74 68 65 20 64 65 | 62 75 67 20 73 74 72 65 |s the de|bug stre|
|000020f0| 61 6d 73 20 74 68 61 74 | 20 77 65 72 65 20 61 75 |ams that| were au|
|00002100| 74 6f 6d 61 74 69 63 61 | 6c 6c 79 20 63 72 65 61 |tomatica|lly crea|
|00002110| 74 65 64 20 62 79 20 4f | 50 46 20 64 75 72 69 6e |ted by O|PF durin|
|00002120| 67 20 70 61 72 74 20 69 | 6e 69 74 69 61 6c 69 7a |g part i|nitializ|
|00002130| 61 74 69 6f 6e 20 28 74 | 68 65 20 64 65 62 75 67 |ation (t|he debug|
|00002140| 20 73 74 72 65 61 6d 73 | 20 65 78 69 73 74 20 66 | streams| exist f|
|00002150| 6f 72 20 74 68 65 20 6c | 69 66 65 20 6f 66 20 79 |or the l|ife of y|
|00002160| 6f 75 72 20 70 61 72 74 | 29 2e 0d 4e 6f 74 65 0d |our part|)..Note.|
|00002170| 41 6c 74 68 6f 75 67 68 | 20 46 57 5f 43 44 65 62 |Although| FW_CDeb|
|00002180| 75 67 43 6f 6e 73 6f 6c | 65 20 64 6f 65 73 20 6e |ugConsol|e does n|
|00002190| 6f 74 20 75 73 65 20 69 | 74 73 20 46 57 5f 43 44 |ot use i|ts FW_CD|
|000021a0| 65 62 75 67 53 74 72 65 | 61 6d 20 66 69 65 6c 64 |ebugStre|am field|
|000021b0| 73 2c 20 46 57 5f 43 44 | 65 62 75 67 43 6f 6e 73 |s, FW_CD|ebugCons|
|000021c0| 6f 6c 65 20 6d 69 67 68 | 74 20 65 76 65 6e 74 75 |ole migh|t eventu|
|000021d0| 61 6c 6c 79 20 62 65 20 | 6d 6f 64 69 66 69 65 64 |ally be |modified|
|000021e0| 20 74 6f 20 75 73 65 20 | 74 68 65 73 65 20 66 69 | to use |these fi|
|000021f0| 65 6c 64 73 2e 20 50 61 | 72 74 20 63 6f 64 65 20 |elds. Pa|rt code |
|00002200| 74 68 61 74 20 75 73 65 | 73 20 46 57 5f 43 44 65 |that use|s FW_CDe|
|00002210| 62 75 67 53 74 72 65 61 | 6d 20 6f 6e 6c 79 20 74 |bugStrea|m only t|
|00002220| 68 72 6f 75 67 68 20 74 | 68 65 20 70 72 6f 76 69 |hrough t|he provi|
|00002230| 64 65 64 20 6d 61 63 72 | 6f 73 20 77 69 6c 6c 20 |ded macr|os will |
|00002240| 70 72 6f 62 61 62 6c 79 | 20 6e 6f 74 20 62 65 20 |probably| not be |
|00002250| 61 66 66 65 63 74 65 64 | 20 77 68 65 6e 20 46 57 |affected| when FW|
|00002260| 5f 43 44 65 62 75 67 43 | 6f 6e 73 6f 6c 65 20 69 |_CDebugC|onsole i|
|00002270| 73 20 6d 6f 64 69 66 69 | 65 64 20 74 6f 20 75 73 |s modifi|ed to us|
|00002280| 65 20 46 57 5f 43 44 65 | 62 75 67 53 74 72 65 61 |e FW_CDe|bugStrea|
|00002290| 6d 2e 0d 0d 53 75 62 63 | 6c 61 73 73 69 6e 67 20 |m...Subc|lassing |
|000022a0| 46 57 5f 43 44 65 62 75 | 67 43 6f 6e 73 6f 6c 65 |FW_CDebu|gConsole|
|000022b0| 0d 49 66 20 79 6f 75 20 | 77 61 6e 74 20 74 6f 20 |.If you |want to |
|000022c0| 63 68 61 6e 67 65 20 74 | 68 65 20 62 65 68 61 76 |change t|he behav|
|000022d0| 69 6f 72 20 6f 66 20 74 | 68 65 20 64 65 62 75 67 |ior of t|he debug|
|000022e0| 67 69 6e 67 20 61 63 74 | 69 6f 6e 73 2c 20 74 68 |ging act|ions, th|
|000022f0| 65 6e 20 79 6f 75 20 77 | 69 6c 6c 20 6e 65 65 64 |en you w|ill need|
|00002300| 20 74 6f 20 63 72 65 61 | 74 65 20 61 20 73 75 62 | to crea|te a sub|
|00002310| 63 6c 61 73 73 20 6f 66 | 20 46 57 5f 43 44 65 62 |class of| FW_CDeb|
|00002320| 75 67 43 6f 6e 73 6f 6c | 65 20 61 6e 64 20 69 6e |ugConsol|e and in|
|00002330| 73 74 61 6c 6c 20 61 6e | 20 69 6e 73 74 61 6e 63 |stall an| instanc|
|00002340| 65 20 6f 66 20 74 68 65 | 20 73 75 62 63 6c 61 73 |e of the| subclas|
|00002350| 73 20 61 73 20 74 68 65 | 20 64 65 62 75 67 20 63 |s as the| debug c|
|00002360| 6f 6e 73 6f 6c 65 20 64 | 75 72 69 6e 67 20 79 6f |onsole d|uring yo|
|00002370| 75 72 20 70 61 72 74 20 | 69 6e 69 74 69 61 6c 69 |ur part |initiali|
|00002380| 7a 61 74 69 6f 6e 3b 20 | 75 73 65 20 74 68 65 20 |zation; |use the |
|00002390| 53 65 74 43 6f 6e 73 6f | 6c 65 28 29 20 6d 65 74 |SetConso|le() met|
|000023a0| 68 6f 64 2e 0d 59 6f 75 | 20 6d 69 67 68 74 20 77 |hod..You| might w|
|000023b0| 61 6e 74 20 74 6f 20 69 | 6e 73 74 61 6c 6c 20 79 |ant to i|nstall y|
|000023c0| 6f 75 72 20 73 75 62 63 | 6c 61 73 73 20 64 65 62 |our subc|lass deb|
|000023d0| 75 67 20 63 6f 6e 73 6f | 6c 65 20 6f 6e 6c 79 20 |ug conso|le only |
|000023e0| 74 65 6d 70 6f 72 61 72 | 69 6c 79 2c 20 69 6e 20 |temporar|ily, in |
|000023f0| 77 68 69 63 68 20 63 61 | 73 65 20 79 6f 75 20 73 |which ca|se you s|
|00002400| 68 6f 75 6c 64 20 73 61 | 76 65 20 74 68 65 20 70 |hould sa|ve the p|
|00002410| 6f 69 6e 74 65 72 20 72 | 65 74 75 72 6e 65 64 20 |ointer r|eturned |
|00002420| 62 79 20 74 68 65 20 53 | 65 74 43 6f 6e 73 6f 6c |by the S|etConsol|
|00002430| 65 28 29 20 6d 65 74 68 | 6f 64 20 73 6f 20 74 68 |e() meth|od so th|
|00002440| 61 74 20 79 6f 75 20 63 | 61 6e 20 72 65 73 65 74 |at you c|an reset|
|00002450| 20 74 68 65 20 64 65 62 | 75 67 20 63 6f 6e 73 6f | the deb|ug conso|
|00002460| 6c 65 20 74 6f 20 74 68 | 65 20 6f 72 69 67 69 6e |le to th|e origin|
|00002470| 61 6c 20 64 65 62 75 67 | 20 63 6f 6e 73 6f 6c 65 |al debug| console|
|00002480| 20 77 68 65 6e 20 79 6f | 75 20 6e 6f 20 6c 6f 6e | when yo|u no lon|
|00002490| 67 65 72 20 6e 65 65 64 | 20 79 6f 75 72 20 74 65 |ger need| your te|
|000024a0| 6d 70 6f 72 61 72 79 20 | 64 65 62 75 67 20 63 6f |mporary |debug co|
|000024b0| 6e 73 6f 6c 65 2e 20 49 | 66 20 79 6f 75 20 61 72 |nsole. I|f you ar|
|000024c0| 65 20 69 6e 73 74 61 6c | 6c 69 6e 67 20 79 6f 75 |e instal|ling you|
|000024d0| 72 20 64 65 62 75 67 20 | 63 6f 6e 73 6f 6c 65 20 |r debug |console |
|000024e0| 66 6f 72 20 74 68 65 20 | 6c 69 66 65 20 6f 66 20 |for the |life of |
|000024f0| 79 6f 75 72 20 70 61 72 | 74 2c 20 74 68 65 6e 20 |your par|t, then |
|00002500| 79 6f 75 20 73 68 6f 75 | 6c 64 20 73 69 6d 70 6c |you shou|ld simpl|
|00002510| 79 20 69 67 6e 6f 72 65 | 20 74 68 65 20 66 75 6e |y ignore| the fun|
|00002520| 63 74 69 6f 6e 20 72 65 | 73 75 6c 74 20 6f 66 20 |ction re|sult of |
|00002530| 53 65 74 43 6f 6e 73 6f | 6c 65 28 29 2e 0d 57 61 |SetConso|le()..Wa|
|00002540| 72 6e 69 6e 67 0d 57 61 | 72 6e 69 6e 67 0d 44 6f |rning.Wa|rning.Do|
|00002550| 20 6e 6f 74 20 64 65 6c | 65 74 65 20 74 68 65 20 | not del|ete the |
|00002560| 70 6f 69 6e 74 65 72 20 | 74 6f 20 74 68 65 20 70 |pointer |to the p|
|00002570| 72 65 76 69 6f 75 73 6c | 79 20 69 6e 73 74 61 6c |reviousl|y instal|
|00002580| 6c 65 64 20 28 64 65 66 | 61 75 6c 74 29 20 64 65 |led (def|ault) de|
|00002590| 62 75 67 20 63 6f 6e 73 | 6f 6c 65 3b 20 6f 6e 6c |bug cons|ole; onl|
|000025a0| 79 20 64 65 6c 65 74 65 | 20 74 68 65 20 46 57 5f |y delete| the FW_|
|000025b0| 43 44 65 62 75 67 43 6f | 6e 73 6f 6c 65 20 6f 62 |CDebugCo|nsole ob|
|000025c0| 6a 65 63 74 20 74 68 61 | 74 20 79 6f 75 20 63 72 |ject tha|t you cr|
|000025d0| 65 61 74 65 64 2e 0d 0d | 4f 76 65 72 72 69 64 69 |eated...|Overridi|
|000025e0| 6e 67 20 46 57 5f 43 44 | 65 62 75 67 43 6f 6e 73 |ng FW_CD|ebugCons|
|000025f0| 6f 6c 65 20 6d 65 74 68 | 6f 64 73 0d 59 6f 75 20 |ole meth|ods.You |
|00002600| 6f 76 65 72 72 69 64 65 | 20 74 68 72 65 65 20 6d |override| three m|
|00002610| 65 74 68 6f 64 73 3a 20 | 44 6f 44 65 62 75 67 67 |ethods: |DoDebugg|
|00002620| 65 72 28 29 2c 20 44 6f | 44 65 62 75 67 d0 4d 65 |er(), Do|Debug.Me|
|00002630| 73 73 61 67 65 28 29 2c | 20 61 6e 64 20 44 6f 4c |ssage(),| and DoL|
|00002640| 6f 67 4d 65 73 73 61 67 | 65 28 29 2e 0d 46 57 5f |ogMessag|e()..FW_|
|00002650| 43 44 65 62 75 67 43 6f | 6e 73 6f 6c 65 20 4d 65 |CDebugCo|nsole Me|
|00002660| 74 68 6f 64 73 0d 0d 46 | 57 5f 43 44 65 62 75 67 |thods..F|W_CDebug|
|00002670| 43 6f 6e 73 6f 6c 65 28 | 29 3b 0d 0d 43 6f 6e 73 |Console(|);..Cons|
|00002680| 74 72 75 63 74 73 20 61 | 20 46 57 5f 43 44 65 62 |tructs a| FW_CDeb|
|00002690| 75 67 43 6f 6e 73 6f 6c | 65 20 6f 62 6a 65 63 74 |ugConsol|e object|
|000026a0| 2e 0d 0d 76 69 72 74 75 | 61 6c 20 7e 46 57 5f 43 |...virtu|al ~FW_C|
|000026b0| 44 65 62 75 67 43 6f 6e | 73 6f 6c 65 28 29 3b 0d |DebugCon|sole();.|
|000026c0| 0d 45 6d 70 74 79 20 64 | 65 73 74 72 75 63 74 6f |.Empty d|estructo|
|000026d0| 72 2e 0d 0d 73 74 61 74 | 69 63 20 76 6f 69 64 20 |r...stat|ic void |
|000026e0| 44 65 62 75 67 67 65 72 | 28 29 3b 0d 0d 53 75 73 |Debugger|();..Sus|
|000026f0| 70 65 6e 64 73 20 6e 6f | 72 6d 61 6c 20 65 78 65 |pends no|rmal exe|
|00002700| 63 75 74 69 6f 6e 20 62 | 79 20 64 72 6f 70 70 69 |cution b|y droppi|
|00002710| 6e 67 20 69 6e 74 6f 20 | 74 68 65 20 6c 6f 77 2d |ng into |the low-|
|00002720| 6c 65 76 65 6c 20 64 65 | 62 75 67 67 65 72 20 77 |level de|bugger w|
|00002730| 69 74 68 6f 75 74 20 64 | 69 73 70 6c 61 79 69 6e |ithout d|isplayin|
|00002740| 67 20 61 20 6d 65 73 73 | 61 67 65 2e 0d 0d 73 74 |g a mess|age...st|
|00002750| 61 74 69 63 20 76 6f 69 | 64 20 44 65 62 75 67 4d |atic voi|d DebugM|
|00002760| 65 73 73 61 67 65 28 63 | 6f 6e 73 74 20 63 68 61 |essage(c|onst cha|
|00002770| 72 2a 20 6d 65 73 73 61 | 67 65 29 3b 0d 0d 53 75 |r* messa|ge);..Su|
|00002780| 73 70 65 6e 64 73 20 6e | 6f 72 6d 61 6c 20 65 78 |spends n|ormal ex|
|00002790| 65 63 75 74 69 6f 6e 20 | 62 79 20 64 72 6f 70 70 |ecution |by dropp|
|000027a0| 69 6e 67 20 69 6e 74 6f | 20 74 68 65 20 6c 6f 77 |ing into| the low|
|000027b0| 2d 6c 65 76 65 6c 20 64 | 65 62 75 67 67 65 72 20 |-level d|ebugger |
|000027c0| 61 6e 64 20 64 69 73 70 | 6c 61 79 73 20 74 68 65 |and disp|lays the|
|000027d0| 20 67 69 76 65 6e 20 6d | 65 73 73 61 67 65 2e 0d | given m|essage..|
|000027e0| 0d 76 69 72 74 75 61 6c | 20 76 6f 69 64 20 44 6f |.virtual| void Do|
|000027f0| 44 65 62 75 67 67 65 72 | 28 29 3b 0d 0d 53 75 73 |Debugger|();..Sus|
|00002800| 70 65 6e 64 73 20 6e 6f | 72 6d 61 6c 20 65 78 65 |pends no|rmal exe|
|00002810| 63 75 74 69 6f 6e 20 62 | 79 20 64 72 6f 70 70 69 |cution b|y droppi|
|00002820| 6e 67 20 69 6e 74 6f 20 | 74 68 65 20 6c 6f 77 2d |ng into |the low-|
|00002830| 6c 65 76 65 6c 20 64 65 | 62 75 67 67 65 72 20 77 |level de|bugger w|
|00002840| 69 74 68 6f 75 74 20 64 | 69 73 70 6c 61 79 69 6e |ithout d|isplayin|
|00002850| 67 20 61 20 6d 65 73 73 | 61 67 65 2e 20 54 68 69 |g a mess|age. Thi|
|00002860| 73 20 69 73 20 61 20 70 | 72 6f 74 65 63 74 65 64 |s is a p|rotected|
|00002870| 20 6d 65 74 68 6f 64 2e | 0d 0d 76 69 72 74 75 61 | method.|..virtua|
|00002880| 6c 20 76 6f 69 64 20 44 | 6f 44 65 62 75 67 4d 65 |l void D|oDebugMe|
|00002890| 73 73 61 67 65 28 63 6f | 6e 73 74 20 63 68 61 72 |ssage(co|nst char|
|000028a0| 2a 20 6d 65 73 73 61 67 | 65 29 3b 0d 0d 53 75 73 |* messag|e);..Sus|
|000028b0| 70 65 6e 64 73 20 6e 6f | 72 6d 61 6c 20 65 78 65 |pends no|rmal exe|
|000028c0| 63 75 74 69 6f 6e 20 62 | 79 20 64 72 6f 70 70 69 |cution b|y droppi|
|000028d0| 6e 67 20 69 6e 74 6f 20 | 74 68 65 20 6c 6f 77 2d |ng into |the low-|
|000028e0| 6c 65 76 65 6c 20 64 65 | 62 75 67 67 65 72 20 61 |level de|bugger a|
|000028f0| 6e 64 20 64 69 73 70 6c | 61 79 73 20 74 68 65 20 |nd displ|ays the |
|00002900| 67 69 76 65 6e 20 6d 65 | 73 73 61 67 65 2e 20 54 |given me|ssage. T|
|00002910| 68 69 73 20 69 73 20 61 | 20 70 72 6f 74 65 63 74 |his is a| protect|
|00002920| 65 64 20 6d 65 74 68 6f | 64 2e 0d 0d 0d 76 69 72 |ed metho|d....vir|
|00002930| 74 75 61 6c 20 76 6f 69 | 64 20 44 6f 4c 6f 67 4d |tual voi|d DoLogM|
|00002940| 65 73 73 61 67 65 28 63 | 6f 6e 73 74 20 63 68 61 |essage(c|onst cha|
|00002950| 72 2a 20 6d 65 73 73 61 | 67 65 29 3b 0d 0d 44 69 |r* messa|ge);..Di|
|00002960| 73 70 6c 61 79 73 20 74 | 68 65 20 6d 65 73 73 61 |splays t|he messa|
|00002970| 67 65 2c 20 70 72 65 66 | 65 72 61 62 6c 79 20 77 |ge, pref|erably w|
|00002980| 69 74 68 6f 75 74 20 73 | 75 73 70 65 6e 64 69 6e |ithout s|uspendin|
|00002990| 67 20 65 78 65 63 75 74 | 69 6f 6e 2e 20 54 68 69 |g execut|ion. Thi|
|000029a0| 73 20 69 73 20 61 20 70 | 72 6f 74 65 63 74 65 64 |s is a p|rotected|
|000029b0| 20 6d 65 74 68 6f 64 2e | 0d 0d 73 74 61 74 69 63 | method.|..static|
|000029c0| 20 46 57 5f 43 44 65 62 | 75 67 43 6f 6e 73 6f 6c | FW_CDeb|ugConsol|
|000029d0| 65 2a 20 47 65 74 43 6f | 6e 73 6f 6c 65 28 29 3b |e* GetCo|nsole();|
|000029e0| 0d 0d 47 65 74 73 20 74 | 68 65 20 63 75 72 72 65 |..Gets t|he curre|
|000029f0| 6e 74 6c 79 20 69 6e 73 | 74 61 6c 6c 65 64 20 64 |ntly ins|talled d|
|00002a00| 65 62 75 67 20 63 6f 6e | 73 6f 6c 65 2e 0d 0d 46 |ebug con|sole...F|
|00002a10| 57 5f 43 44 65 62 75 67 | 53 74 72 65 61 6d 20 26 |W_CDebug|Stream &|
|00002a20| 20 47 65 74 46 61 74 61 | 6c 45 72 72 6f 72 53 74 | GetFata|lErrorSt|
|00002a30| 72 65 61 6d 28 29 3b 0d | 0d 47 65 74 73 20 74 68 |ream();.|.Gets th|
|00002a40| 65 20 66 61 74 61 6c 20 | 65 72 72 6f 72 20 73 74 |e fatal |error st|
|00002a50| 72 65 61 6d 2e 0d 0d 46 | 57 5f 43 44 65 62 75 67 |ream...F|W_CDebug|
|00002a60| 53 74 72 65 61 6d 20 26 | 20 47 65 74 4e 6f 74 69 |Stream &| GetNoti|
|00002a70| 66 69 63 61 74 69 6f 6e | 53 74 72 65 61 6d 28 29 |fication|Stream()|
|00002a80| 3b 0d 0d 47 65 74 73 20 | 74 68 65 20 6e 6f 74 69 |;..Gets |the noti|
|00002a90| 66 69 63 61 74 69 6f 6e | 20 73 74 72 65 61 6d 2e |fication| stream.|
|00002aa0| 0d 0d 46 57 5f 43 44 65 | 62 75 67 53 74 72 65 61 |..FW_CDe|bugStrea|
|00002ab0| 6d 20 26 20 47 65 74 57 | 61 72 6e 69 6e 67 53 74 |m & GetW|arningSt|
|00002ac0| 72 65 61 6d 28 29 3b 0d | 0d 47 65 74 73 20 74 68 |ream();.|.Gets th|
|00002ad0| 65 20 77 61 72 6e 69 6e | 67 20 73 74 72 65 61 6d |e warnin|g stream|
|00002ae0| 2e 0d 0d 73 74 61 74 69 | 63 20 76 6f 69 64 20 4c |...stati|c void L|
|00002af0| 6f 67 4d 65 73 73 61 67 | 65 28 63 6f 6e 73 74 20 |ogMessag|e(const |
|00002b00| 63 68 61 72 2a 20 6d 65 | 73 73 61 67 65 29 3b 0d |char* me|ssage);.|
|00002b10| 0d 44 69 73 70 6c 61 79 | 73 20 74 68 65 20 6d 65 |.Display|s the me|
|00002b20| 73 73 61 67 65 2c 20 70 | 72 65 66 65 72 61 62 6c |ssage, p|referabl|
|00002b30| 79 20 77 69 74 68 6f 75 | 74 20 73 75 73 70 65 6e |y withou|t suspen|
|00002b40| 64 69 6e 67 20 65 78 65 | 63 75 74 69 6f 6e 2e 0d |ding exe|cution..|
|00002b50| 0d 73 74 61 74 69 63 20 | 46 57 5f 43 44 65 62 75 |.static |FW_CDebu|
|00002b60| 67 43 6f 6e 73 6f 6c 65 | 2a 20 53 65 74 43 6f 6e |gConsole|* SetCon|
|00002b70| 73 6f 6c 65 28 46 57 5f | 43 44 65 62 75 67 43 6f |sole(FW_|CDebugCo|
|00002b80| 6e 73 6f 6c 65 2a 20 63 | 6f 6e 73 6f 6c 65 29 3b |nsole* c|onsole);|
|00002b90| 0d 0d 49 6e 73 74 61 6c | 6c 73 20 61 20 6e 65 77 |..Instal|ls a new|
|00002ba0| 20 64 65 62 75 67 20 63 | 6f 6e 73 6f 6c 65 2e 20 | debug c|onsole. |
|00002bb0| 52 65 74 75 72 6e 73 20 | 61 20 70 6f 69 6e 74 65 |Returns |a pointe|
|00002bc0| 72 20 74 6f 20 74 68 65 | 20 70 72 65 76 69 6f 75 |r to the| previou|
|00002bd0| 73 6c 79 20 69 6e 73 74 | 61 6c 6c 65 64 20 28 64 |sly inst|alled (d|
|00002be0| 65 66 61 75 6c 74 29 20 | 64 65 62 75 67 20 63 6f |efault) |debug co|
|00002bf0| 6e 73 6f 6c 65 2e 0d 46 | 57 5f 43 44 65 62 75 67 |nsole..F|W_CDebug|
|00002c00| 53 74 72 65 61 6d 20 43 | 6c 61 73 73 0d 49 6e 74 |Stream C|lass.Int|
|00002c10| 72 6f 64 75 63 74 69 6f | 6e 0d 46 57 5f 43 44 65 |roductio|n.FW_CDe|
|00002c20| 62 75 67 53 74 72 65 61 | 6d 20 69 73 20 61 6e 20 |bugStrea|m is an |
|00002c30| 61 62 73 74 72 61 63 74 | 20 62 61 73 65 20 63 6c |abstract| base cl|
|00002c40| 61 73 73 20 66 6f 72 20 | 63 72 65 61 74 69 6e 67 |ass for |creating|
|00002c50| 20 73 70 65 63 69 61 6c | 74 79 20 64 65 62 75 67 | special|ty debug|
|00002c60| 20 73 74 72 65 61 6d 73 | 2e 0d 42 65 63 61 75 73 | streams|..Becaus|
|00002c70| 65 20 46 57 5f 43 44 65 | 62 75 67 53 74 72 65 61 |e FW_CDe|bugStrea|
|00002c80| 6d 20 69 73 20 61 6e 20 | 61 62 73 74 72 61 63 74 |m is an |abstract|
|00002c90| 20 62 61 73 65 20 63 6c | 61 73 73 2c 20 79 6f 75 | base cl|ass, you|
|00002ca0| 20 63 61 6e 6e 6f 74 20 | 69 6e 73 74 61 6e 74 69 | cannot |instanti|
|00002cb0| 61 74 65 20 69 74 2e 20 | 49 6e 73 74 65 61 64 2c |ate it. |Instead,|
|00002cc0| 20 69 6e 73 74 61 6e 74 | 69 61 74 65 20 61 20 63 | instant|iate a c|
|00002cd0| 6c 61 73 73 20 66 72 6f | 6d 20 6f 6e 65 20 6f 66 |lass fro|m one of|
|00002ce0| 20 74 68 65 20 63 6c 61 | 73 73 65 73 20 70 72 6f | the cla|sses pro|
|00002cf0| 76 69 64 65 64 20 61 73 | 20 73 75 62 63 6c 61 73 |vided as| subclas|
|00002d00| 73 65 73 20 6f 66 20 46 | 57 5f 43 44 65 62 75 67 |ses of F|W_CDebug|
|00002d10| 53 74 72 65 61 6d 2e 0d | 46 57 5f 43 44 65 62 75 |Stream..|FW_CDebu|
|00002d20| 67 53 74 72 65 61 6d 20 | 6f 6e 6c 79 20 64 65 70 |gStream |only dep|
|00002d30| 65 6e 64 73 20 6f 6e 20 | 74 68 65 20 66 75 6e 63 |ends on |the func|
|00002d40| 74 69 6f 6e 61 6c 69 74 | 79 20 6f 66 20 74 68 65 |tionalit|y of the|
|00002d50| 20 43 6f 6d 6d 6f 6e 20 | 63 6f 6d 70 6f 6e 65 6e | Common |componen|
|00002d60| 74 2e 0d 48 65 61 64 65 | 72 20 66 69 6c 65 0d 46 |t..Heade|r file.F|
|00002d70| 57 44 62 67 53 74 72 2e | 68 0d 48 65 72 69 74 61 |WDbgStr.|h.Herita|
|00002d80| 67 65 0d 46 57 5f 43 44 | 65 62 75 67 43 6f 6e 73 |ge.FW_CD|ebugCons|
|00002d90| 6f 6c 65 09 37 0d 46 57 | 5f 43 44 65 62 75 67 53 |ole.7.FW|_CDebugS|
|00002da0| 74 72 65 61 6d 0d a5 20 | 46 57 5f 43 42 75 66 66 |tream.. |FW_CBuff|
|00002db0| 65 72 44 65 62 75 67 53 | 74 72 65 61 6d 09 31 35 |erDebugS|tream.15|
|00002dc0| 0d a5 20 46 57 5f 43 46 | 69 6c 65 44 65 62 75 67 |.. FW_CF|ileDebug|
|00002dd0| 53 74 72 65 61 6d 09 31 | 37 0d a5 20 46 57 5f 43 |Stream.1|7.. FW_C|
|00002de0| 4e 75 6c 6c 44 65 62 75 | 67 53 74 72 65 61 6d 09 |NullDebu|gStream.|
|00002df0| 31 39 0d 46 57 5f 43 54 | 72 61 63 65 52 75 6e 74 |19.FW_CT|raceRunt|
|00002e00| 69 6d 65 09 32 31 0d 55 | 73 69 6e 67 20 46 57 5f |ime.21.U|sing FW_|
|00002e10| 43 44 65 62 75 67 53 74 | 72 65 61 6d 0d 55 73 65 |CDebugSt|ream.Use|
|00002e20| 20 46 57 5f 43 44 65 62 | 75 67 53 74 72 65 61 6d | FW_CDeb|ugStream|
|00002e30| 20 74 6f 20 6f 75 74 70 | 75 74 20 66 75 6e 64 61 | to outp|ut funda|
|00002e40| 6d 65 6e 74 61 6c 20 74 | 79 70 65 73 2c 20 70 6f |mental t|ypes, po|
|00002e50| 69 6e 74 65 72 73 2c 20 | 61 6e 64 20 6e 75 6c 6c |inters, |and null|
|00002e60| 2d 74 65 72 6d 69 6e 61 | 74 65 64 20 73 74 72 69 |-termina|ted stri|
|00002e70| 6e 67 73 20 74 6f 20 61 | 20 64 65 62 75 67 20 73 |ngs to a| debug s|
|00002e80| 74 72 65 61 6d 2e 20 4f | 50 46 20 61 75 74 6f 6d |tream. O|PF autom|
|00002e90| 61 74 69 63 61 6c 6c 79 | 20 69 6e 73 65 72 74 73 |atically| inserts|
|00002ea0| 20 61 20 73 70 61 63 65 | 20 28 64 61 74 61 20 73 | a space| (data s|
|00002eb0| 65 70 61 72 61 74 6f 72 | 29 20 62 65 74 77 65 65 |eparator|) betwee|
|00002ec0| 6e 20 65 61 63 68 20 69 | 74 65 6d 20 6f 75 74 70 |n each i|tem outp|
|00002ed0| 75 74 2e 0d 46 57 5f 43 | 44 65 62 75 67 53 74 72 |ut..FW_C|DebugStr|
|00002ee0| 65 61 6d 20 69 73 20 69 | 6e 74 65 6e 64 65 64 20 |eam is i|ntended |
|00002ef0| 66 6f 72 20 64 65 62 75 | 67 20 6f 75 74 70 75 74 |for debu|g output|
|00002f00| 2c 20 61 6e 64 20 74 68 | 75 73 20 77 61 73 20 64 |, and th|us was d|
|00002f10| 65 73 69 67 6e 65 64 20 | 77 69 74 68 20 74 68 72 |esigned |with thr|
|00002f20| 65 65 20 74 68 69 6e 67 | 73 20 69 6e 20 6d 69 6e |ee thing|s in min|
|00002f30| 64 3a 0d 09 31 2e 09 42 | 65 63 61 75 73 65 20 74 |d:..1..B|ecause t|
|00002f40| 68 65 20 44 65 62 75 67 | 20 43 6f 6d 70 6f 6e 65 |he Debug| Compone|
|00002f50| 6e 74 20 69 73 20 6f 6e | 65 20 6f 66 20 74 68 65 |nt is on|e of the|
|00002f60| 20 6d 6f 73 74 20 66 75 | 6e 64 61 6d 65 6e 74 61 | most fu|ndamenta|
|00002f70| 6c 20 4f 50 46 20 63 6f | 6d 70 6f 6e 65 6e 74 73 |l OPF co|mponents|
|00002f80| 2c 20 46 57 5f 43 44 65 | 62 75 67 53 74 72 65 61 |, FW_CDe|bugStrea|
|00002f90| 6d 20 69 73 20 61 6c 6d | 6f 73 74 20 61 6c 77 61 |m is alm|ost alwa|
|00002fa0| 79 73 20 61 76 61 69 6c | 61 62 6c 65 20 66 6f 72 |ys avail|able for|
|00002fb0| 20 75 73 65 2c 20 77 68 | 69 63 68 20 69 73 20 69 | use, wh|ich is i|
|00002fc0| 6d 70 6f 72 74 61 6e 74 | 20 69 66 20 79 6f 75 20 |mportant| if you |
|00002fd0| 77 61 6e 74 20 74 6f 20 | 68 61 76 65 20 64 65 62 |want to |have deb|
|00002fe0| 75 67 20 6f 75 74 70 75 | 74 20 61 76 61 69 6c 61 |ug outpu|t availa|
|00002ff0| 62 6c 65 20 64 75 72 69 | 6e 67 20 70 61 72 74 20 |ble duri|ng part |
|00003000| 69 6e 69 74 69 61 6c 69 | 7a 61 74 69 6f 6e 2e 0d |initiali|zation..|
|00003010| 09 32 2e 09 46 57 5f 43 | 44 65 62 75 67 53 74 72 |.2..FW_C|DebugStr|
|00003020| 65 61 6d 20 6d 61 6b 65 | 73 20 73 6d 61 6c 6c 20 |eam make|s small |
|00003030| 64 65 6d 61 6e 64 73 20 | 6f 6e 20 73 79 73 74 65 |demands |on syste|
|00003040| 6d 20 72 65 73 6f 75 72 | 63 65 73 2c 20 73 6f 20 |m resour|ces, so |
|00003050| 69 74 20 69 73 20 75 6e | 6c 69 6b 65 6c 79 20 74 |it is un|likely t|
|00003060| 6f 20 66 61 69 6c 2e 0d | 09 33 2e 09 54 68 65 72 |o fail..|.3..Ther|
|00003070| 65 20 69 73 20 6c 69 74 | 74 6c 65 20 63 6f 64 65 |e is lit|tle code|
|00003080| 2c 20 73 6f 20 46 57 5f | 43 44 65 62 75 67 53 74 |, so FW_|CDebugSt|
|00003090| 72 65 61 6d 20 69 73 20 | 65 61 73 79 20 74 6f 20 |ream is |easy to |
|000030a0| 74 72 61 63 65 20 69 6e | 74 6f 20 69 66 20 69 74 |trace in|to if it|
|000030b0| 20 6c 6f 6f 6b 73 20 73 | 75 73 70 69 63 69 6f 75 | looks s|uspiciou|
|000030c0| 73 20 64 75 72 69 6e 67 | 20 64 65 62 75 67 67 69 |s during| debuggi|
|000030d0| 6e 67 2e 0d 46 57 5f 43 | 44 65 62 75 67 53 74 72 |ng..FW_C|DebugStr|
|000030e0| 65 61 6d 20 73 75 62 63 | 6c 61 73 73 65 73 0d 59 |eam subc|lasses.Y|
|000030f0| 6f 75 20 68 61 76 65 20 | 61 20 63 68 6f 69 63 65 |ou have |a choice|
|00003100| 20 6f 66 20 74 68 72 65 | 65 20 73 75 62 63 6c 61 | of thre|e subcla|
|00003110| 73 73 65 73 20 66 72 6f | 6d 20 77 68 69 63 68 20 |sses fro|m which |
|00003120| 79 6f 75 20 63 61 6e 20 | 69 6e 73 74 61 6e 74 69 |you can |instanti|
|00003130| 61 74 65 20 79 6f 75 72 | 20 63 6c 61 73 73 3a 0d |ate your| class:.|
|00003140| a5 09 46 57 5f 43 42 75 | 66 66 65 72 44 65 62 75 |..FW_CBu|fferDebu|
|00003150| 67 53 74 72 65 61 6d 20 | 28 70 61 67 65 20 31 35 |gStream |(page 15|
|00003160| 29 0d a5 09 46 57 5f 43 | 46 69 6c 65 44 65 62 75 |)...FW_C|FileDebu|
|00003170| 67 53 74 72 65 61 6d 09 | 20 28 70 61 67 65 20 31 |gStream.| (page 1|
|00003180| 37 29 0d a5 09 46 57 5f | 43 4e 75 6c 6c 44 65 62 |7)...FW_|CNullDeb|
|00003190| 75 67 53 74 72 65 61 6d | 20 28 70 61 67 65 20 31 |ugStream| (page 1|
|000031a0| 39 29 0d 52 65 6c 61 74 | 65 64 20 63 6c 61 73 73 |9).Relat|ed class|
|000031b0| 65 73 0d 54 68 65 20 44 | 65 62 75 67 20 43 6f 6d |es.The D|ebug Com|
|000031c0| 70 6f 6e 65 6e 74 20 70 | 72 6f 76 69 64 65 73 20 |ponent p|rovides |
|000031d0| 63 6c 61 73 73 65 73 20 | 74 68 61 74 20 61 6c 6c |classes |that all|
|000031e0| 6f 77 20 79 6f 75 20 74 | 6f 20 63 72 65 61 74 65 |ow you t|o create|
|000031f0| 20 6d 65 6d 6f 72 79 2c | 20 66 69 6c 65 2c 20 61 | memory,| file, a|
|00003200| 6e 64 20 6e 75 6c 6c 20 | 64 65 62 75 67 20 73 74 |nd null |debug st|
|00003210| 72 65 61 6d 73 2c 20 61 | 73 20 66 6f 6c 6c 6f 77 |reams, a|s follow|
|00003220| 73 3a 0d a5 09 46 57 5f | 43 42 75 66 66 65 72 44 |s:...FW_|CBufferD|
|00003230| 65 62 75 67 53 74 72 65 | 61 6d 20 28 70 61 67 65 |ebugStre|am (page|
|00003240| 20 31 35 29 0d a5 09 46 | 57 5f 43 46 69 6c 65 44 | 15)...F|W_CFileD|
|00003250| 65 62 75 67 53 74 72 65 | 61 6d 09 20 28 70 61 67 |ebugStre|am. (pag|
|00003260| 65 20 31 37 29 0d a5 09 | 46 57 5f 43 4e 75 6c 6c |e 17)...|FW_CNull|
|00003270| 44 65 62 75 67 53 74 72 | 65 61 6d 20 28 70 61 67 |DebugStr|eam (pag|
|00003280| 65 20 31 39 29 0d 53 75 | 62 63 6c 61 73 73 69 6e |e 19).Su|bclassin|
|00003290| 67 20 46 57 5f 43 44 65 | 62 75 67 53 74 72 65 61 |g FW_CDe|bugStrea|
|000032a0| 6d 0d 53 75 62 63 6c 61 | 73 73 20 74 68 69 73 20 |m.Subcla|ss this |
|000032b0| 63 6c 61 73 73 20 74 6f | 20 70 72 6f 76 69 64 65 |class to| provide|
|000032c0| 20 61 20 63 6f 6e 63 72 | 65 74 65 20 64 65 62 75 | a concr|ete debu|
|000032d0| 67 20 73 74 72 65 61 6d | 20 74 68 61 74 20 73 65 |g stream| that se|
|000032e0| 6e 64 73 20 69 74 73 20 | 6f 75 74 70 75 74 20 74 |nds its |output t|
|000032f0| 6f 20 73 6f 6d 65 20 6c | 6f 63 61 74 69 6f 6e 2e |o some l|ocation.|
|00003300| 20 46 6f 72 20 69 6e 73 | 74 61 6e 63 65 2c 20 61 | For ins|tance, a|
|00003310| 20 64 65 62 75 67 20 73 | 74 72 65 61 6d 20 63 6f | debug s|tream co|
|00003320| 75 6c 64 20 62 65 20 63 | 72 65 61 74 65 64 20 74 |uld be c|reated t|
|00003330| 68 61 74 20 73 65 6e 64 | 73 20 69 74 73 20 6f 75 |hat send|s its ou|
|00003340| 74 70 75 74 20 74 6f 20 | 61 20 6e 65 74 77 6f 72 |tput to |a networ|
|00003350| 6b 2e 0d 4f 76 65 72 72 | 69 64 69 6e 67 20 46 57 |k..Overr|iding FW|
|00003360| 5f 43 44 65 62 75 67 53 | 74 72 65 61 6d 20 6d 65 |_CDebugS|tream me|
|00003370| 74 68 6f 64 73 0d 4f 6e | 6c 79 20 74 68 65 20 57 |thods.On|ly the W|
|00003380| 72 69 74 65 28 29 20 6d | 65 74 68 6f 64 20 6d 75 |rite() m|ethod mu|
|00003390| 73 74 20 62 65 20 6f 76 | 65 72 72 69 64 64 65 6e |st be ov|erridden|
|000033a0| 2e 20 54 68 65 20 57 72 | 69 74 65 28 29 20 6d 65 |. The Wr|ite() me|
|000033b0| 74 68 6f 64 20 73 68 6f | 75 6c 64 20 73 65 6e 64 |thod sho|uld send|
|000033c0| 20 69 74 73 20 6f 75 74 | 70 75 74 20 74 6f 20 73 | its out|put to s|
|000033d0| 6f 6d 65 20 6c 6f 63 61 | 74 69 6f 6e 3b 20 66 6f |ome loca|tion; fo|
|000033e0| 72 20 65 78 61 6d 70 6c | 65 2c 20 61 20 66 69 6c |r exampl|e, a fil|
|000033f0| 65 2c 20 6d 65 6d 6f 72 | 79 2c 20 6f 72 20 61 20 |e, memor|y, or a |
|00003400| 6e 65 74 77 6f 72 6b 2e | 0d 46 57 5f 43 44 65 62 |network.|.FW_CDeb|
|00003410| 75 67 53 74 72 65 61 6d | 20 4d 65 74 68 6f 64 73 |ugStream| Methods|
|00003420| 0d 0d 46 57 5f 43 44 65 | 62 75 67 53 74 72 65 61 |..FW_CDe|bugStrea|
|00003430| 6d 28 29 3b 0d 0d 45 6d | 70 74 79 20 63 6f 6e 73 |m();..Em|pty cons|
|00003440| 74 72 75 63 74 6f 72 2e | 0d 0d 76 69 72 74 75 61 |tructor.|..virtua|
|00003450| 6c 20 7e 46 57 5f 43 44 | 65 62 75 67 53 74 72 65 |l ~FW_CD|ebugStre|
|00003460| 61 6d 28 29 3b 0d 0d 45 | 6d 70 74 79 20 64 65 73 |am();..E|mpty des|
|00003470| 74 72 75 63 74 6f 72 2e | 0d 0d 66 72 69 65 6e 64 |tructor.|..friend|
|00003480| 20 46 57 5f 43 44 65 62 | 75 67 53 74 72 65 61 6d | FW_CDeb|ugStream|
|00003490| 20 26 45 6e 64 4c 69 6e | 65 28 46 57 5f 43 44 65 | &EndLin|e(FW_CDe|
|000034a0| 62 75 67 53 74 72 65 61 | 6d 20 26 29 3b 0d 0d 49 |bugStrea|m &);..I|
|000034b0| 6e 73 65 72 74 73 20 61 | 6e 20 65 6e 64 2d 6f 66 |nserts a|n end-of|
|000034c0| 2d 6c 69 6e 65 20 63 68 | 61 72 61 63 74 65 72 20 |-line ch|aracter |
|000034d0| 69 6e 74 6f 20 74 68 65 | 20 64 65 62 75 67 20 73 |into the| debug s|
|000034e0| 74 72 65 61 6d 2e 0d 0d | 0d 46 57 5f 43 44 65 62 |tream...|.FW_CDeb|
|000034f0| 75 67 53 74 72 65 61 6d | 20 26 6f 70 65 72 61 74 |ugStream| &operat|
|00003500| 6f 72 3c 3c 28 63 6f 6e | 73 74 20 63 68 61 72 20 |or<<(con|st char |
|00003510| 2a 73 74 72 69 6e 67 29 | 3b 0d 0d 57 72 69 74 65 |*string)|;..Write|
|00003520| 73 20 61 20 6e 75 6c 6c | 2d 74 65 72 6d 69 6e 61 |s a null|-termina|
|00003530| 74 65 64 20 63 68 61 72 | 61 63 74 65 72 20 73 74 |ted char|acter st|
|00003540| 72 69 6e 67 20 69 6e 74 | 6f 20 74 68 65 20 64 65 |ring int|o the de|
|00003550| 62 75 67 20 73 74 72 65 | 61 6d 2e 0d 0d 46 57 5f |bug stre|am...FW_|
|00003560| 43 44 65 62 75 67 53 74 | 72 65 61 6d 20 26 6f 70 |CDebugSt|ream &op|
|00003570| 65 72 61 74 6f 72 3c 3c | 28 63 6f 6e 73 74 20 73 |erator<<|(const s|
|00003580| 69 67 6e 65 64 20 63 68 | 61 72 20 2a 73 74 72 69 |igned ch|ar *stri|
|00003590| 6e 67 29 3b 0d 0d 57 72 | 69 74 65 73 20 61 20 73 |ng);..Wr|ites a s|
|000035a0| 69 67 6e 65 64 20 6e 75 | 6c 6c 2d 74 65 72 6d 69 |igned nu|ll-termi|
|000035b0| 6e 61 74 65 64 20 63 68 | 61 72 61 63 74 65 72 20 |nated ch|aracter |
|000035c0| 73 74 72 69 6e 67 20 69 | 6e 74 6f 20 74 68 65 20 |string i|nto the |
|000035d0| 64 65 62 75 67 20 73 74 | 72 65 61 6d 2e 0d 0d 46 |debug st|ream...F|
|000035e0| 57 5f 43 44 65 62 75 67 | 53 74 72 65 61 6d 20 26 |W_CDebug|Stream &|
|000035f0| 6f 70 65 72 61 74 6f 72 | 3c 3c 28 63 6f 6e 73 74 |operator|<<(const|
|00003600| 20 75 6e 73 69 67 6e 65 | 64 20 63 68 61 72 20 2a | unsigne|d char *|
|00003610| 73 74 72 69 6e 67 29 3b | 0d 0d 57 72 69 74 65 73 |string);|..Writes|
|00003620| 20 61 6e 20 75 6e 73 69 | 67 6e 65 64 20 6e 75 6c | an unsi|gned nul|
|00003630| 6c 2d 74 65 72 6d 69 6e | 61 74 65 64 20 63 68 61 |l-termin|ated cha|
|00003640| 72 61 63 74 65 72 20 73 | 74 72 69 6e 67 20 69 6e |racter s|tring in|
|00003650| 74 6f 20 74 68 65 20 64 | 65 62 75 67 20 73 74 72 |to the d|ebug str|
|00003660| 65 61 6d 2e 0d 0d 46 57 | 5f 43 44 65 62 75 67 53 |eam...FW|_CDebugS|
|00003670| 74 72 65 61 6d 20 26 6f | 70 65 72 61 74 6f 72 3c |tream &o|perator<|
|00003680| 3c 28 63 68 61 72 20 63 | 29 3b 0d 0d 57 72 69 74 |<(char c|);..Writ|
|00003690| 65 73 20 61 20 63 68 61 | 72 61 63 74 65 72 20 69 |es a cha|racter i|
|000036a0| 6e 74 6f 20 74 68 65 20 | 64 65 62 75 67 20 73 74 |nto the |debug st|
|000036b0| 72 65 61 6d 2e 0d 0d 46 | 57 5f 43 44 65 62 75 67 |ream...F|W_CDebug|
|000036c0| 53 74 72 65 61 6d 20 26 | 6f 70 65 72 61 74 6f 72 |Stream &|operator|
|000036d0| 3c 3c 28 73 69 67 6e 65 | 64 20 63 68 61 72 20 63 |<<(signe|d char c|
|000036e0| 29 3b 0d 0d 57 72 69 74 | 65 73 20 61 20 73 69 67 |);..Writ|es a sig|
|000036f0| 6e 65 64 20 63 68 61 72 | 61 63 74 65 72 20 69 6e |ned char|acter in|
|00003700| 74 6f 20 74 68 65 20 64 | 65 62 75 67 20 73 74 72 |to the d|ebug str|
|00003710| 65 61 6d 2e 0d 0d 46 57 | 5f 43 44 65 62 75 67 53 |eam...FW|_CDebugS|
|00003720| 74 72 65 61 6d 20 26 6f | 70 65 72 61 74 6f 72 3c |tream &o|perator<|
|00003730| 3c 28 75 6e 73 69 67 6e | 65 64 20 63 68 61 72 20 |<(unsign|ed char |
|00003740| 63 29 3b 0d 0d 57 72 69 | 74 65 73 20 61 6e 20 75 |c);..Wri|tes an u|
|00003750| 6e 73 69 67 6e 65 64 20 | 63 68 61 72 61 63 74 65 |nsigned |characte|
|00003760| 72 20 69 6e 74 6f 20 74 | 68 65 20 64 65 62 75 67 |r into t|he debug|
|00003770| 20 73 74 72 65 61 6d 2e | 0d 0d 46 57 5f 43 44 65 | stream.|..FW_CDe|
|00003780| 62 75 67 53 74 72 65 61 | 6d 20 26 6f 70 65 72 61 |bugStrea|m &opera|
|00003790| 74 6f 72 3c 3c 28 73 68 | 6f 72 74 20 6e 29 3b 0d |tor<<(sh|ort n);.|
|000037a0| 0d 57 72 69 74 65 73 20 | 61 20 73 68 6f 72 74 20 |.Writes |a short |
|000037b0| 69 6e 74 6f 20 74 68 65 | 20 64 65 62 75 67 20 73 |into the| debug s|
|000037c0| 74 72 65 61 6d 2e 0d 0d | 46 57 5f 43 44 65 62 75 |tream...|FW_CDebu|
|000037d0| 67 53 74 72 65 61 6d 20 | 26 6f 70 65 72 61 74 6f |gStream |&operato|
|000037e0| 72 3c 3c 28 69 6e 74 20 | 6e 29 3b 0d 0d 57 72 69 |r<<(int |n);..Wri|
|000037f0| 74 65 73 20 61 6e 20 69 | 6e 74 65 67 65 72 20 69 |tes an i|nteger i|
|00003800| 6e 74 6f 20 74 68 65 20 | 64 65 62 75 67 20 73 74 |nto the |debug st|
|00003810| 72 65 61 6d 2e 0d 0d 0d | 46 57 5f 43 44 65 62 75 |ream....|FW_CDebu|
|00003820| 67 53 74 72 65 61 6d 20 | 26 6f 70 65 72 61 74 6f |gStream |&operato|
|00003830| 72 3c 3c 28 6c 6f 6e 67 | 20 6e 29 3b 0d 0d 57 72 |r<<(long| n);..Wr|
|00003840| 69 74 65 73 20 61 20 6c | 6f 6e 67 20 69 6e 74 6f |ites a l|ong into|
|00003850| 20 74 68 65 20 64 65 62 | 75 67 20 73 74 72 65 61 | the deb|ug strea|
|00003860| 6d 2e 0d 0d 46 57 5f 43 | 44 65 62 75 67 53 74 72 |m...FW_C|DebugStr|
|00003870| 65 61 6d 20 26 6f 70 65 | 72 61 74 6f 72 3c 3c 28 |eam &ope|rator<<(|
|00003880| 75 6e 73 69 67 6e 65 64 | 20 73 68 6f 72 74 20 6e |unsigned| short n|
|00003890| 29 3b 0d 0d 57 72 69 74 | 65 73 20 61 6e 20 75 6e |);..Writ|es an un|
|000038a0| 73 69 67 6e 65 64 20 73 | 68 6f 72 74 20 69 6e 74 |signed s|hort int|
|000038b0| 6f 20 74 68 65 20 64 65 | 62 75 67 20 73 74 72 65 |o the de|bug stre|
|000038c0| 61 6d 2e 0d 0d 46 57 5f | 43 44 65 62 75 67 53 74 |am...FW_|CDebugSt|
|000038d0| 72 65 61 6d 20 26 6f 70 | 65 72 61 74 6f 72 3c 3c |ream &op|erator<<|
|000038e0| 28 75 6e 73 69 67 6e 65 | 64 20 6e 29 3b 0d 0d 57 |(unsigne|d n);..W|
|000038f0| 72 69 74 65 73 20 61 6e | 20 75 6e 73 69 67 6e 65 |rites an| unsigne|
|00003900| 64 20 69 6e 74 65 67 65 | 72 20 69 6e 74 6f 20 74 |d intege|r into t|
|00003910| 68 65 20 64 65 62 75 67 | 20 73 74 72 65 61 6d 2e |he debug| stream.|
|00003920| 0d 0d 46 57 5f 43 44 65 | 62 75 67 53 74 72 65 61 |..FW_CDe|bugStrea|
|00003930| 6d 20 26 6f 70 65 72 61 | 74 6f 72 3c 3c 28 75 6e |m &opera|tor<<(un|
|00003940| 73 69 67 6e 65 64 20 6c | 6f 6e 67 20 6e 29 3b 0d |signed l|ong n);.|
|00003950| 0d 57 72 69 74 65 73 20 | 61 6e 20 75 6e 73 69 67 |.Writes |an unsig|
|00003960| 6e 65 64 20 6c 6f 6e 67 | 20 69 6e 74 6f 20 74 68 |ned long| into th|
|00003970| 65 20 64 65 62 75 67 20 | 73 74 72 65 61 6d 2e 0d |e debug |stream..|
|00003980| 0d 46 57 5f 43 44 65 62 | 75 67 53 74 72 65 61 6d |.FW_CDeb|ugStream|
|00003990| 20 26 6f 70 65 72 61 74 | 6f 72 3c 3c 28 76 6f 69 | &operat|or<<(voi|
|000039a0| 64 20 2a 29 3b 0d 0d 57 | 72 69 74 65 73 20 61 20 |d *);..W|rites a |
|000039b0| 68 65 78 61 64 65 63 69 | 6d 61 6c 20 61 64 64 72 |hexadeci|mal addr|
|000039c0| 65 73 73 20 69 6e 74 6f | 20 74 68 65 20 64 65 62 |ess into| the deb|
|000039d0| 75 67 20 73 74 72 65 61 | 6d 2e 0d 0d 76 69 72 74 |ug strea|m...virt|
|000039e0| 75 61 6c 20 63 6c 61 73 | 73 20 46 57 5f 43 44 65 |ual clas|s FW_CDe|
|000039f0| 62 75 67 53 74 72 65 61 | 6d 20 26 57 72 69 74 65 |bugStrea|m &Write|
|00003a00| 28 63 6f 6e 73 74 20 76 | 6f 69 64 20 2a 64 61 74 |(const v|oid *dat|
|00003a10| 61 2c 20 73 69 7a 65 5f | 74 20 73 69 7a 65 29 20 |a, size_|t size) |
|00003a20| 3d 20 30 3b 0d 0d 54 68 | 65 20 57 72 69 74 65 28 |= 0;..Th|e Write(|
|00003a30| 29 20 6d 65 74 68 6f 64 | 20 69 73 20 69 6e 74 65 |) method| is inte|
|00003a40| 6e 64 65 64 20 74 6f 20 | 77 72 69 74 65 20 74 68 |nded to |write th|
|00003a50| 65 20 72 61 77 20 64 61 | 74 61 20 77 69 74 68 6f |e raw da|ta witho|
|00003a60| 75 74 20 61 6e 79 20 64 | 61 74 61 20 73 65 70 61 |ut any d|ata sepa|
|00003a70| 72 61 74 6f 72 2e 0d 0d | 46 57 5f 43 44 65 62 75 |rator...|FW_CDebu|
|00003a80| 67 53 74 72 65 61 6d 20 | 26 20 57 72 69 74 65 42 |gStream |& WriteB|
|00003a90| 61 73 65 31 30 4e 75 6d | 62 65 72 28 6c 6f 6e 67 |ase10Num|ber(long|
|00003aa0| 20 6e 29 3b 0d 0d 57 72 | 69 74 65 73 20 61 20 62 | n);..Wr|ites a b|
|00003ab0| 61 73 65 2d 31 30 20 6c | 6f 6e 67 20 69 6e 74 6f |ase-10 l|ong into|
|00003ac0| 20 74 68 65 20 64 65 62 | 75 67 20 73 74 72 65 61 | the deb|ug strea|
|00003ad0| 6d 2e 20 54 68 69 73 20 | 69 73 20 61 20 70 72 6f |m. This |is a pro|
|00003ae0| 74 65 63 74 65 64 20 6d | 65 74 68 6f 64 2e 0d 0d |tected m|ethod...|
|00003af0| 46 57 5f 43 44 65 62 75 | 67 53 74 72 65 61 6d 20 |FW_CDebu|gStream |
|00003b00| 26 20 57 72 69 74 65 42 | 61 73 65 31 36 4e 75 6d |& WriteB|ase16Num|
|00003b10| 62 65 72 28 6c 6f 6e 67 | 20 6e 29 3b 0d 0d 57 72 |ber(long| n);..Wr|
|00003b20| 69 74 65 73 20 61 20 62 | 61 73 65 2d 31 36 20 6c |ites a b|ase-16 l|
|00003b30| 6f 6e 67 20 69 6e 74 6f | 20 74 68 65 20 64 65 62 |ong into| the deb|
|00003b40| 75 67 20 73 74 72 65 61 | 6d 2e 20 54 68 69 73 20 |ug strea|m. This |
|00003b50| 69 73 20 61 20 70 72 6f | 74 65 63 74 65 64 20 6d |is a pro|tected m|
|00003b60| 65 74 68 6f 64 2e 0d 0d | 46 57 5f 43 44 65 62 75 |ethod...|FW_CDebu|
|00003b70| 67 53 74 72 65 61 6d 20 | 26 57 72 69 74 65 43 68 |gStream |&WriteCh|
|00003b80| 75 6e 6b 28 63 6f 6e 73 | 74 20 76 6f 69 64 20 2a |unk(cons|t void *|
|00003b90| 64 61 74 61 2c 0d 09 09 | 09 09 09 09 09 09 09 73 |data,...|.......s|
|00003ba0| 69 7a 65 5f 74 20 73 69 | 7a 65 29 3b 0d 0d 57 72 |ize_t si|ze);..Wr|
|00003bb0| 69 74 65 73 20 72 61 77 | 20 64 61 74 61 20 77 69 |ites raw| data wi|
|00003bc0| 74 68 20 61 20 64 61 74 | 61 20 73 65 70 61 72 61 |th a dat|a separa|
|00003bd0| 74 6f 72 20 69 6e 74 6f | 20 74 68 65 20 64 65 62 |tor into| the deb|
|00003be0| 75 67 20 73 74 72 65 61 | 6d 2e 0d 46 57 5f 43 42 |ug strea|m..FW_CB|
|00003bf0| 75 66 66 65 72 44 65 62 | 75 67 53 74 72 65 61 6d |ufferDeb|ugStream|
|00003c00| 20 43 6c 61 73 73 0d 49 | 6e 74 72 6f 64 75 63 74 | Class.I|ntroduct|
|00003c10| 69 6f 6e 0d 46 57 5f 43 | 42 75 66 66 65 72 44 65 |ion.FW_C|BufferDe|
|00003c20| 62 75 67 53 74 72 65 61 | 6d 20 69 73 20 61 20 73 |bugStrea|m is a s|
|00003c30| 75 62 63 6c 61 73 73 20 | 6f 66 20 46 57 5f 43 44 |ubclass |of FW_CD|
|00003c40| 65 62 75 67 53 74 72 65 | 61 6d 2e 20 49 74 20 69 |ebugStre|am. It i|
|00003c50| 73 20 61 20 63 6f 6e 63 | 72 65 74 65 20 63 6c 61 |s a conc|rete cla|
|00003c60| 73 73 20 66 6f 72 20 63 | 72 65 61 74 69 6e 67 20 |ss for c|reating |
|00003c70| 6d 65 6d 6f 72 79 20 64 | 65 62 75 67 20 73 74 72 |memory d|ebug str|
|00003c80| 65 61 6d 73 2e 20 54 68 | 65 20 64 65 62 75 67 20 |eams. Th|e debug |
|00003c90| 6f 75 74 70 75 74 20 69 | 73 20 70 75 74 20 69 6e |output i|s put in|
|00003ca0| 74 6f 20 61 20 62 6c 6f | 63 6b 20 6f 66 20 6d 65 |to a blo|ck of me|
|00003cb0| 6d 6f 72 79 20 75 6e 74 | 69 6c 20 74 68 65 20 6d |mory unt|il the m|
|00003cc0| 65 6d 6f 72 79 20 62 6c | 6f 63 6b 20 69 73 20 66 |emory bl|ock is f|
|00003cd0| 75 6c 6c 3b 20 61 6e 79 | 20 61 64 64 69 74 69 6f |ull; any| additio|
|00003ce0| 6e 61 6c 20 6f 75 74 70 | 75 74 20 69 73 20 69 67 |nal outp|ut is ig|
|00003cf0| 6e 6f 72 65 64 2e 0d 54 | 6f 20 69 6e 73 74 61 6e |nored..T|o instan|
|00003d00| 74 69 61 74 65 20 46 57 | 5f 43 42 75 66 66 65 72 |tiate FW|_CBuffer|
|00003d10| 44 65 62 75 67 53 74 72 | 65 61 6d 2c 20 79 6f 75 |DebugStr|eam, you|
|00003d20| 20 6e 65 65 64 20 6f 6e | 6c 79 20 61 20 70 6f 69 | need on|ly a poi|
|00003d30| 6e 74 65 72 20 74 6f 20 | 61 6e 20 61 6c 72 65 61 |nter to |an alrea|
|00003d40| 64 79 20 65 78 69 73 74 | 69 6e 67 20 62 6c 6f 63 |dy exist|ing bloc|
|00003d50| 6b 20 6f 66 20 6d 65 6d | 6f 72 79 20 61 6e 64 20 |k of mem|ory and |
|00003d60| 74 68 65 20 62 6c 6f 63 | 6b 20 73 69 7a 65 2e 20 |the bloc|k size. |
|00003d70| 0d 48 65 61 64 65 72 20 | 66 69 6c 65 0d 46 57 44 |.Header |file.FWD|
|00003d80| 62 67 53 74 72 2e 68 0d | 48 65 72 69 74 61 67 65 |bgStr.h.|Heritage|
|00003d90| 0d 46 57 5f 43 44 65 62 | 75 67 43 6f 6e 73 6f 6c |.FW_CDeb|ugConsol|
|00003da0| 65 09 37 0d 46 57 5f 43 | 44 65 62 75 67 53 74 72 |e.7.FW_C|DebugStr|
|00003db0| 65 61 6d 09 31 31 0d a5 | 20 46 57 5f 43 42 75 66 |eam.11..| FW_CBuf|
|00003dc0| 66 65 72 44 65 62 75 67 | 53 74 72 65 61 6d 0d a5 |ferDebug|Stream..|
|00003dd0| 20 46 57 5f 43 46 69 6c | 65 44 65 62 75 67 53 74 | FW_CFil|eDebugSt|
|00003de0| 72 65 61 6d 09 31 37 0d | a5 20 46 57 5f 43 4e 75 |ream.17.|. FW_CNu|
|00003df0| 6c 6c 44 65 62 75 67 53 | 74 72 65 61 6d 09 31 39 |llDebugS|tream.19|
|00003e00| 0d 46 57 5f 43 54 72 61 | 63 65 52 75 6e 74 69 6d |.FW_CTra|ceRuntim|
|00003e10| 65 09 32 31 0d 55 73 69 | 6e 67 20 46 57 5f 43 42 |e.21.Usi|ng FW_CB|
|00003e20| 75 66 66 65 72 44 65 62 | 75 67 53 74 72 65 61 6d |ufferDeb|ugStream|
|00003e30| 0d 55 73 65 20 46 57 5f | 43 42 75 66 66 65 72 44 |.Use FW_|CBufferD|
|00003e40| 65 62 75 67 53 74 72 65 | 61 6d 20 77 68 65 6e 20 |ebugStre|am when |
|00003e50| 79 6f 75 20 77 61 6e 74 | 20 64 65 62 75 67 20 6f |you want| debug o|
|00003e60| 75 74 70 75 74 20 74 6f | 20 67 6f 20 74 6f 20 61 |utput to| go to a|
|00003e70| 20 6d 65 6d 6f 72 79 20 | 62 6c 6f 63 6b 2e 20 59 | memory |block. Y|
|00003e80| 6f 75 20 6d 69 67 68 74 | 20 77 61 6e 74 20 69 74 |ou might| want it|
|00003e90| 20 74 6f 20 67 6f 20 74 | 6f 20 61 20 6d 65 6d 6f | to go t|o a memo|
|00003ea0| 72 79 20 62 6c 6f 63 6b | 20 72 61 74 68 65 72 20 |ry block| rather |
|00003eb0| 74 68 61 6e 20 61 20 66 | 69 6c 65 2c 20 66 6f 72 |than a f|ile, for|
|00003ec0| 20 69 6e 73 74 61 6e 63 | 65 2c 20 62 65 63 61 75 | instanc|e, becau|
|00003ed0| 73 65 20 79 6f 75 20 61 | 72 65 20 63 6f 6e 63 65 |se you a|re conce|
|00003ee0| 72 6e 65 64 20 74 68 61 | 74 20 77 72 69 74 69 6e |rned tha|t writin|
|00003ef0| 67 20 74 6f 20 61 20 66 | 69 6c 65 20 69 73 20 63 |g to a f|ile is c|
|00003f00| 68 61 6e 67 69 6e 67 20 | 74 68 65 20 64 65 62 75 |hanging |the debu|
|00003f10| 67 20 73 74 61 74 65 20 | 6f 66 20 74 68 65 20 6d |g state |of the m|
|00003f20| 61 63 68 69 6e 65 2c 20 | 6f 72 20 74 68 61 74 20 |achine, |or that |
|00003f30| 74 68 65 20 66 69 6c 65 | 20 49 2f 4f 20 69 73 20 |the file| I/O is |
|00003f40| 74 6f 6f 20 73 6c 6f 77 | 2c 20 6c 69 6b 65 20 77 |too slow|, like w|
|00003f50| 68 65 6e 20 79 6f 75 20 | 61 72 65 20 64 65 62 75 |hen you |are debu|
|00003f60| 67 67 69 6e 67 20 72 65 | 61 6c 2d 74 69 6d 65 20 |gging re|al-time |
|00003f70| 63 6f 64 65 2e 0d 46 57 | 5f 43 42 75 66 66 65 72 |code..FW|_CBuffer|
|00003f80| 44 65 62 75 67 53 74 72 | 65 61 6d 20 73 75 62 63 |DebugStr|eam subc|
|00003f90| 6c 61 73 73 65 73 0d 54 | 68 65 72 65 20 61 72 65 |lasses.T|here are|
|00003fa0| 20 6e 6f 20 73 75 62 63 | 6c 61 73 73 65 73 20 6f | no subc|lasses o|
|00003fb0| 66 20 74 68 69 73 20 63 | 6c 61 73 73 2e 0d 52 65 |f this c|lass..Re|
|00003fc0| 6c 61 74 65 64 20 63 6c | 61 73 73 65 73 0d 54 68 |lated cl|asses.Th|
|00003fd0| 65 20 44 65 62 75 67 20 | 43 6f 6d 70 6f 6e 65 6e |e Debug |Componen|
|00003fe0| 74 20 70 72 6f 76 69 64 | 65 73 20 63 6c 61 73 73 |t provid|es class|
|00003ff0| 65 73 20 74 68 61 74 20 | 61 6c 6c 6f 77 20 79 6f |es that |allow yo|
|00004000| 75 20 74 6f 20 6f 75 74 | 70 75 74 20 66 75 6e 64 |u to out|put fund|
|00004010| 61 6d 65 6e 74 61 6c 20 | 74 79 70 65 73 2c 20 70 |amental |types, p|
|00004020| 6f 69 6e 74 65 72 73 2c | 20 61 6e 64 20 6e 75 6c |ointers,| and nul|
|00004030| 6c 2d 74 65 72 6d 69 6e | 61 74 65 64 20 73 74 72 |l-termin|ated str|
|00004040| 69 6e 67 73 20 74 6f 20 | 61 20 64 65 62 75 67 20 |ings to |a debug |
|00004050| 73 74 72 65 61 6d 2c 20 | 61 6e 64 20 63 72 65 61 |stream, |and crea|
|00004060| 74 65 20 66 69 6c 65 20 | 61 6e 64 20 6e 75 6c 6c |te file |and null|
|00004070| 20 64 65 62 75 67 20 73 | 74 72 65 61 6d 73 2c 20 | debug s|treams, |
|00004080| 61 73 20 66 6f 6c 6c 6f | 77 73 3a 0d a5 09 46 57 |as follo|ws:...FW|
|00004090| 5f 43 44 65 62 75 67 53 | 74 72 65 61 6d 20 28 70 |_CDebugS|tream (p|
|000040a0| 61 67 65 20 31 31 29 0d | a5 09 46 57 5f 43 46 69 |age 11).|..FW_CFi|
|000040b0| 6c 65 44 65 62 75 67 53 | 74 72 65 61 6d 09 20 28 |leDebugS|tream. (|
|000040c0| 70 61 67 65 20 31 37 29 | 0d a5 09 46 57 5f 43 4e |page 17)|...FW_CN|
|000040d0| 75 6c 6c 44 65 62 75 67 | 53 74 72 65 61 6d 20 28 |ullDebug|Stream (|
|000040e0| 70 61 67 65 20 31 39 29 | 0d 53 75 62 63 6c 61 73 |page 19)|.Subclas|
|000040f0| 73 69 6e 67 20 46 57 5f | 43 42 75 66 66 65 72 44 |sing FW_|CBufferD|
|00004100| 65 62 75 67 53 74 72 65 | 61 6d 0d 59 6f 75 20 75 |ebugStre|am.You u|
|00004110| 73 75 61 6c 6c 79 20 64 | 6f 20 6e 6f 74 20 73 75 |sually d|o not su|
|00004120| 62 63 6c 61 73 73 20 74 | 68 69 73 20 63 6c 61 73 |bclass t|his clas|
|00004130| 73 2e 0d 46 57 5f 43 42 | 75 66 66 65 72 44 65 62 |s..FW_CB|ufferDeb|
|00004140| 75 67 53 74 72 65 61 6d | 20 4d 65 74 68 6f 64 73 |ugStream| Methods|
|00004150| 0d 0d 46 57 5f 43 42 75 | 66 66 65 72 44 65 62 75 |..FW_CBu|fferDebu|
|00004160| 67 53 74 72 65 61 6d 28 | 76 6f 69 64 20 2a 20 62 |gStream(|void * b|
|00004170| 75 66 66 65 72 2c 0d 09 | 09 09 09 09 09 09 73 69 |uffer,..|......si|
|00004180| 7a 65 5f 74 20 62 75 66 | 66 65 72 53 69 7a 65 29 |ze_t buf|ferSize)|
|00004190| 3b 0d 0d 45 6d 70 74 79 | 20 63 6f 6e 73 74 72 75 |;..Empty| constru|
|000041a0| 63 74 6f 72 2e 0d 0d 76 | 69 72 74 75 61 6c 20 46 |ctor...v|irtual F|
|000041b0| 57 5f 43 44 65 62 75 67 | 53 74 72 65 61 6d 20 26 |W_CDebug|Stream &|
|000041c0| 57 72 69 74 65 28 63 6f | 6e 73 74 20 76 6f 69 64 |Write(co|nst void|
|000041d0| 20 2a 64 61 74 61 2c 0d | 09 09 09 09 09 09 09 09 | *data,.|........|
|000041e0| 09 09 73 69 7a 65 5f 74 | 20 73 69 7a 65 29 3b 0d |..size_t| size);.|
|000041f0| 0d 57 72 69 74 65 73 20 | 64 61 74 61 20 69 6e 74 |.Writes |data int|
|00004200| 6f 20 61 20 6d 65 6d 6f | 72 79 20 64 65 62 75 67 |o a memo|ry debug|
|00004210| 20 73 74 72 65 61 6d 2e | 20 54 68 65 20 64 65 62 | stream.| The deb|
|00004220| 75 67 20 6f 75 74 70 75 | 74 20 69 73 20 70 75 74 |ug outpu|t is put|
|00004230| 20 69 6e 74 6f 20 61 20 | 62 6c 6f 63 6b 20 6f 66 | into a |block of|
|00004240| 20 6d 65 6d 6f 72 79 20 | 75 6e 74 69 6c 20 74 68 | memory |until th|
|00004250| 65 20 6d 65 6d 6f 72 79 | 20 62 6c 6f 63 6b 20 69 |e memory| block i|
|00004260| 73 20 66 75 6c 6c 3b 20 | 61 6e 79 20 61 64 64 69 |s full; |any addi|
|00004270| 74 69 6f 6e 61 6c 20 6f | 75 74 70 75 74 20 69 73 |tional o|utput is|
|00004280| 20 69 67 6e 6f 72 65 64 | 2e 0d 46 57 5f 43 46 69 | ignored|..FW_CFi|
|00004290| 6c 65 44 65 62 75 67 53 | 74 72 65 61 6d 20 43 6c |leDebugS|tream Cl|
|000042a0| 61 73 73 0d 49 6e 74 72 | 6f 64 75 63 74 69 6f 6e |ass.Intr|oduction|
|000042b0| 0d 46 57 5f 43 46 69 6c | 65 44 65 62 75 67 53 74 |.FW_CFil|eDebugSt|
|000042c0| 72 65 61 6d 20 69 73 20 | 61 20 73 75 62 63 6c 61 |ream is |a subcla|
|000042d0| 73 73 20 6f 66 20 46 57 | 5f 43 44 65 62 75 67 53 |ss of FW|_CDebugS|
|000042e0| 74 72 65 61 6d 2e 20 49 | 74 20 69 73 20 61 20 63 |tream. I|t is a c|
|000042f0| 6f 6e 63 72 65 74 65 20 | 63 6c 61 73 73 20 66 6f |oncrete |class fo|
|00004300| 72 20 63 72 65 61 74 69 | 6e 67 20 66 69 6c 65 20 |r creati|ng file |
|00004310| 64 65 62 75 67 20 73 74 | 72 65 61 6d 73 2e 20 54 |debug st|reams. T|
|00004320| 68 65 20 64 65 62 75 67 | 20 6f 75 74 70 75 74 20 |he debug| output |
|00004330| 69 73 20 73 65 6e 74 20 | 74 6f 20 61 20 66 69 6c |is sent |to a fil|
|00004340| 65 2e 0d 54 6f 20 69 6e | 73 74 61 6e 74 69 61 74 |e..To in|stantiat|
|00004350| 65 20 46 57 5f 43 46 69 | 6c 65 44 65 62 75 67 53 |e FW_CFi|leDebugS|
|00004360| 74 72 65 61 6d 2c 20 79 | 6f 75 20 6e 65 65 64 20 |tream, y|ou need |
|00004370| 6f 6e 6c 79 20 74 68 65 | 20 6e 61 6d 65 20 6f 66 |only the| name of|
|00004380| 20 61 20 66 69 6c 65 20 | 79 6f 75 20 77 61 6e 74 | a file |you want|
|00004390| 20 74 6f 20 73 65 6e 64 | 20 74 68 65 20 6f 75 74 | to send| the out|
|000043a0| 70 75 74 20 74 6f 2e 20 | 49 74 20 74 68 65 20 66 |put to. |It the f|
|000043b0| 69 6c 65 20 61 6c 72 65 | 61 64 79 20 65 78 69 73 |ile alre|ady exis|
|000043c0| 74 73 2c 20 64 69 73 63 | 61 72 64 20 74 68 65 20 |ts, disc|ard the |
|000043d0| 70 72 65 76 69 6f 75 73 | 20 63 6f 6e 74 65 6e 74 |previous| content|
|000043e0| 73 2e 20 49 66 20 74 68 | 65 20 66 69 6c 65 20 64 |s. If th|e file d|
|000043f0| 6f 65 73 6e d5 74 20 65 | 78 69 73 74 2c 20 63 72 |oesn.t e|xist, cr|
|00004400| 65 61 74 65 20 69 74 2e | 20 49 66 20 61 20 70 61 |eate it.| If a pa|
|00004410| 74 68 20 69 73 20 73 70 | 65 63 69 66 69 65 64 20 |th is sp|ecified |
|00004420| 66 6f 72 20 74 68 65 20 | 66 69 6c 65 2c 20 74 68 |for the |file, th|
|00004430| 65 6e 20 69 74 20 6d 75 | 73 74 20 62 65 20 61 20 |en it mu|st be a |
|00004440| 70 6c 61 74 66 6f 72 6d | 2d 73 70 65 63 69 66 69 |platform|-specifi|
|00004450| 63 20 70 61 74 68 2e 20 | 4e 6f 20 74 72 61 6e 73 |c path. |No trans|
|00004460| 6c 61 74 69 6f 6e 20 66 | 72 6f 6d 20 74 68 65 20 |lation f|rom the |
|00004470| 4d 61 63 69 6e 74 6f 73 | 68 20 70 61 74 68 20 73 |Macintos|h path s|
|00004480| 70 65 63 69 66 69 63 61 | 74 69 6f 6e 20 73 74 79 |pecifica|tion sty|
|00004490| 6c 65 20 74 6f 20 74 68 | 65 20 57 69 6e 64 6f 77 |le to th|e Window|
|000044a0| 73 20 70 61 74 68 20 73 | 70 65 63 69 66 69 63 61 |s path s|pecifica|
|000044b0| 74 69 6f 6e 20 73 74 79 | 6c 65 20 69 73 20 64 6f |tion sty|le is do|
|000044c0| 6e 65 2c 20 6f 72 20 76 | 69 63 65 20 76 65 72 73 |ne, or v|ice vers|
|000044d0| 61 2e 20 0d 48 65 61 64 | 65 72 20 66 69 6c 65 0d |a. .Head|er file.|
|000044e0| 46 57 44 62 67 53 74 72 | 2e 68 0d 48 65 72 69 74 |FWDbgStr|.h.Herit|
|000044f0| 61 67 65 0d 46 57 5f 43 | 44 65 62 75 67 43 6f 6e |age.FW_C|DebugCon|
|00004500| 73 6f 6c 65 09 37 0d 46 | 57 5f 43 44 65 62 75 67 |sole.7.F|W_CDebug|
|00004510| 53 74 72 65 61 6d 09 31 | 31 0d a5 20 46 57 5f 43 |Stream.1|1.. FW_C|
|00004520| 42 75 66 66 65 72 44 65 | 62 75 67 53 74 72 65 61 |BufferDe|bugStrea|
|00004530| 6d 09 31 35 0d a5 20 46 | 57 5f 43 46 69 6c 65 44 |m.15.. F|W_CFileD|
|00004540| 65 62 75 67 53 74 72 65 | 61 6d 0d a5 20 46 57 5f |ebugStre|am.. FW_|
|00004550| 43 4e 75 6c 6c 44 65 62 | 75 67 53 74 72 65 61 6d |CNullDeb|ugStream|
|00004560| 09 31 39 0d 46 57 5f 43 | 54 72 61 63 65 52 75 6e |.19.FW_C|TraceRun|
|00004570| 74 69 6d 65 09 32 31 0d | 55 73 69 6e 67 20 46 57 |time.21.|Using FW|
|00004580| 5f 43 46 69 6c 65 44 65 | 62 75 67 53 74 72 65 61 |_CFileDe|bugStrea|
|00004590| 6d 0d 55 73 65 20 46 57 | 5f 43 46 69 6c 65 44 65 |m.Use FW|_CFileDe|
|000045a0| 62 75 67 53 74 72 65 61 | 6d 20 77 68 65 6e 20 79 |bugStrea|m when y|
|000045b0| 6f 75 20 77 61 6e 74 20 | 64 65 62 75 67 20 6f 75 |ou want |debug ou|
|000045c0| 74 70 75 74 20 74 6f 20 | 62 65 20 73 65 6e 74 20 |tput to |be sent |
|000045d0| 74 6f 20 61 20 66 69 6c | 65 2e 20 54 68 69 73 20 |to a fil|e. This |
|000045e0| 69 73 20 70 61 72 74 69 | 63 75 6c 61 72 6c 79 20 |is parti|cularly |
|000045f0| 75 73 65 66 75 6c 20 77 | 68 65 6e 20 74 68 65 72 |useful w|hen ther|
|00004600| 65 20 69 73 20 61 20 6c | 6f 74 20 6f 66 20 6f 75 |e is a l|ot of ou|
|00004610| 74 70 75 74 2e 0d 46 57 | 5f 43 46 69 6c 65 44 65 |tput..FW|_CFileDe|
|00004620| 62 75 67 53 74 72 65 61 | 6d 20 73 75 62 63 6c 61 |bugStrea|m subcla|
|00004630| 73 73 65 73 0d 54 68 65 | 72 65 20 61 72 65 20 6e |sses.The|re are n|
|00004640| 6f 20 73 75 62 63 6c 61 | 73 73 65 73 20 6f 66 20 |o subcla|sses of |
|00004650| 74 68 69 73 20 63 6c 61 | 73 73 2e 0d 52 65 6c 61 |this cla|ss..Rela|
|00004660| 74 65 64 20 63 6c 61 73 | 73 65 73 0d 54 68 65 20 |ted clas|ses.The |
|00004670| 44 65 62 75 67 20 43 6f | 6d 70 6f 6e 65 6e 74 20 |Debug Co|mponent |
|00004680| 70 72 6f 76 69 64 65 73 | 20 63 6c 61 73 73 65 73 |provides| classes|
|00004690| 20 74 68 61 74 20 61 6c | 6c 6f 77 20 79 6f 75 20 | that al|low you |
|000046a0| 74 6f 20 6f 75 74 70 75 | 74 20 66 75 6e 64 61 6d |to outpu|t fundam|
|000046b0| 65 6e 74 61 6c 20 74 79 | 70 65 73 2c 20 70 6f 69 |ental ty|pes, poi|
|000046c0| 6e 74 65 72 73 2c 20 61 | 6e 64 20 6e 75 6c 6c 2d |nters, a|nd null-|
|000046d0| 74 65 72 6d 69 6e 61 74 | 65 64 20 73 74 72 69 6e |terminat|ed strin|
|000046e0| 67 73 20 74 6f 20 61 20 | 64 65 62 75 67 20 73 74 |gs to a |debug st|
|000046f0| 72 65 61 6d 2c 20 61 6e | 64 20 63 72 65 61 74 65 |ream, an|d create|
|00004700| 20 6d 65 6d 6f 72 79 20 | 61 6e 64 20 6e 75 6c 6c | memory |and null|
|00004710| 20 64 65 62 75 67 20 73 | 74 72 65 61 6d 73 2c 20 | debug s|treams, |
|00004720| 61 73 20 66 6f 6c 6c 6f | 77 73 3a 0d a5 09 46 57 |as follo|ws:...FW|
|00004730| 5f 43 44 65 62 75 67 53 | 74 72 65 61 6d 20 28 70 |_CDebugS|tream (p|
|00004740| 61 67 65 20 31 31 29 0d | a5 09 46 57 5f 43 42 75 |age 11).|..FW_CBu|
|00004750| 66 66 65 72 44 65 62 75 | 67 53 74 72 65 61 6d 09 |fferDebu|gStream.|
|00004760| 20 28 70 61 67 65 20 31 | 35 29 0d a5 09 46 57 5f | (page 1|5)...FW_|
|00004770| 43 4e 75 6c 6c 44 65 62 | 75 67 53 74 72 65 61 6d |CNullDeb|ugStream|
|00004780| 20 28 70 61 67 65 20 31 | 39 29 0d 53 75 62 63 6c | (page 1|9).Subcl|
|00004790| 61 73 73 69 6e 67 20 46 | 57 5f 43 46 69 6c 65 44 |assing F|W_CFileD|
|000047a0| 65 62 75 67 53 74 72 65 | 61 6d 0d 59 6f 75 20 75 |ebugStre|am.You u|
|000047b0| 73 75 61 6c 6c 79 20 64 | 6f 20 6e 6f 74 20 73 75 |sually d|o not su|
|000047c0| 62 63 6c 61 73 73 20 74 | 68 69 73 20 63 6c 61 73 |bclass t|his clas|
|000047d0| 73 2e 0d 46 57 5f 43 46 | 69 6c 65 44 65 62 75 67 |s..FW_CF|ileDebug|
|000047e0| 53 74 72 65 61 6d 20 4d | 65 74 68 6f 64 73 0d 0d |Stream M|ethods..|
|000047f0| 46 57 5f 43 46 69 6c 65 | 44 65 62 75 67 53 74 72 |FW_CFile|DebugStr|
|00004800| 65 61 6d 28 63 68 61 72 | 20 2a 66 69 6c 65 4e 61 |eam(char| *fileNa|
|00004810| 6d 65 29 3b 0d 0d 43 6f | 6e 73 74 72 75 63 74 73 |me);..Co|nstructs|
|00004820| 20 61 20 46 57 5f 43 46 | 69 6c 65 44 65 62 75 67 | a FW_CF|ileDebug|
|00004830| 53 74 72 65 61 6d 20 6f | 62 6a 65 63 74 2e 20 4f |Stream o|bject. O|
|00004840| 70 65 6e 73 20 74 68 65 | 20 73 70 65 63 69 66 69 |pens the| specifi|
|00004850| 65 64 20 66 69 6c 65 2e | 0d 0d 7e 46 57 5f 43 46 |ed file.|..~FW_CF|
|00004860| 69 6c 65 44 65 62 75 67 | 53 74 72 65 61 6d 28 29 |ileDebug|Stream()|
|00004870| 3b 0d 0d 52 65 6c 65 61 | 73 65 73 20 74 68 65 20 |;..Relea|ses the |
|00004880| 46 57 5f 43 46 69 6c 65 | 44 65 62 75 67 53 74 72 |FW_CFile|DebugStr|
|00004890| 65 61 6d 20 6f 62 6a 65 | 63 74 2e 20 43 6c 6f 73 |eam obje|ct. Clos|
|000048a0| 65 73 20 74 68 65 20 73 | 70 65 63 69 66 69 65 64 |es the s|pecified|
|000048b0| 20 66 69 6c 65 2e 0d 0d | 76 69 72 74 75 61 6c 20 | file...|virtual |
|000048c0| 46 57 5f 43 44 65 62 75 | 67 53 74 72 65 61 6d 20 |FW_CDebu|gStream |
|000048d0| 26 57 72 69 74 65 28 63 | 6f 6e 73 74 20 76 6f 69 |&Write(c|onst voi|
|000048e0| 64 20 2a 64 61 74 61 2c | 0d 09 09 09 09 09 09 09 |d *data,|........|
|000048f0| 09 09 09 73 69 7a 65 5f | 74 20 73 69 7a 65 29 3b |...size_|t size);|
|00004900| 0d 0d 57 72 69 74 65 73 | 20 64 61 74 61 20 69 6e |..Writes| data in|
|00004910| 74 6f 20 61 20 66 69 6c | 65 20 64 65 62 75 67 20 |to a fil|e debug |
|00004920| 73 74 72 65 61 6d 2e 20 | 54 68 65 20 64 65 62 75 |stream. |The debu|
|00004930| 67 20 6f 75 74 70 75 74 | 20 69 73 20 73 65 6e 74 |g output| is sent|
|00004940| 20 74 6f 20 61 20 66 69 | 6c 65 2e 0d 46 57 5f 43 | to a fi|le..FW_C|
|00004950| 4e 75 6c 6c 44 65 62 75 | 67 53 74 72 65 61 6d 20 |NullDebu|gStream |
|00004960| 43 6c 61 73 73 0d 49 6e | 74 72 6f 64 75 63 74 69 |Class.In|troducti|
|00004970| 6f 6e 0d 46 57 5f 43 4e | 75 6c 6c 44 65 62 75 67 |on.FW_CN|ullDebug|
|00004980| 53 74 72 65 61 6d 20 69 | 73 20 61 20 73 75 62 63 |Stream i|s a subc|
|00004990| 6c 61 73 73 20 6f 66 20 | 46 57 5f 43 44 65 62 75 |lass of |FW_CDebu|
|000049a0| 67 53 74 72 65 61 6d 2e | 20 49 74 20 69 73 20 61 |gStream.| It is a|
|000049b0| 20 63 6f 6e 63 72 65 74 | 65 20 63 6c 61 73 73 20 | concret|e class |
|000049c0| 66 6f 72 20 63 72 65 61 | 74 69 6e 67 20 6e 75 6c |for crea|ting nul|
|000049d0| 6c 20 64 65 62 75 67 20 | 73 74 72 65 61 6d 73 2e |l debug |streams.|
|000049e0| 20 54 68 65 20 64 65 62 | 75 67 20 6f 75 74 70 75 | The deb|ug outpu|
|000049f0| 74 20 69 73 20 69 67 6e | 6f 72 65 64 2e 0d 54 6f |t is ign|ored..To|
|00004a00| 20 69 6e 73 74 61 6e 74 | 69 61 74 65 20 46 57 5f | instant|iate FW_|
|00004a10| 43 4e 75 6c 6c 44 65 62 | 75 67 53 74 72 65 61 6d |CNullDeb|ugStream|
|00004a20| 2c 20 79 6f 75 20 6e 65 | 65 64 20 6f 6e 6c 79 20 |, you ne|ed only |
|00004a30| 74 6f 20 64 65 63 6c 61 | 72 65 20 69 74 2e 20 0d |to decla|re it. .|
|00004a40| 48 65 61 64 65 72 20 66 | 69 6c 65 0d 46 57 44 62 |Header f|ile.FWDb|
|00004a50| 67 53 74 72 2e 68 0d 48 | 65 72 69 74 61 67 65 0d |gStr.h.H|eritage.|
|00004a60| 46 57 5f 43 44 65 62 75 | 67 43 6f 6e 73 6f 6c 65 |FW_CDebu|gConsole|
|00004a70| 09 37 0d 46 57 5f 43 44 | 65 62 75 67 53 74 72 65 |.7.FW_CD|ebugStre|
|00004a80| 61 6d 09 31 31 0d a5 20 | 46 57 5f 43 42 75 66 66 |am.11.. |FW_CBuff|
|00004a90| 65 72 44 65 62 75 67 53 | 74 72 65 61 6d 09 31 35 |erDebugS|tream.15|
|00004aa0| 0d a5 20 46 57 5f 43 46 | 69 6c 65 44 65 62 75 67 |.. FW_CF|ileDebug|
|00004ab0| 53 74 72 65 61 6d 09 31 | 37 0d a5 20 46 57 5f 43 |Stream.1|7.. FW_C|
|00004ac0| 4e 75 6c 6c 44 65 62 75 | 67 53 74 72 65 61 6d 0d |NullDebu|gStream.|
|00004ad0| 46 57 5f 43 54 72 61 63 | 65 52 75 6e 74 69 6d 65 |FW_CTrac|eRuntime|
|00004ae0| 09 32 31 0d 55 73 69 6e | 67 20 46 57 5f 43 4e 75 |.21.Usin|g FW_CNu|
|00004af0| 6c 6c 44 65 62 75 67 53 | 74 72 65 61 6d 0d 55 73 |llDebugS|tream.Us|
|00004b00| 65 20 46 57 5f 43 4e 75 | 6c 6c 44 65 62 75 67 53 |e FW_CNu|llDebugS|
|00004b10| 74 72 65 61 6d 20 77 68 | 65 6e 20 79 6f 75 20 77 |tream wh|en you w|
|00004b20| 61 6e 74 20 64 65 62 75 | 67 20 6f 75 74 70 75 74 |ant debu|g output|
|00004b30| 20 74 6f 20 62 65 20 69 | 67 6e 6f 72 65 64 20 6f | to be i|gnored o|
|00004b40| 72 20 64 72 6f 70 70 65 | 64 2e 20 54 68 69 73 20 |r droppe|d. This |
|00004b50| 69 73 20 70 61 72 74 69 | 63 75 6c 61 72 6c 79 20 |is parti|cularly |
|00004b60| 75 73 65 66 75 6c 20 77 | 68 65 6e 20 79 6f 75 20 |useful w|hen you |
|00004b70| 6f 75 74 70 75 74 20 61 | 20 6c 6f 74 20 6f 66 20 |output a| lot of |
|00004b80| 64 65 62 75 67 20 69 6e | 66 6f 72 6d 61 74 69 6f |debug in|formatio|
|00004b90| 6e 20 61 6e 64 20 79 6f | 75 20 77 61 6e 74 20 74 |n and yo|u want t|
|00004ba0| 6f 20 73 75 73 70 65 6e | 64 20 69 74 20 66 6f 72 |o suspen|d it for|
|00004bb0| 20 61 20 70 65 72 69 6f | 64 20 6f 66 20 74 69 6d | a perio|d of tim|
|00004bc0| 65 2e 20 59 6f 75 20 63 | 61 6e 20 73 65 74 20 74 |e. You c|an set t|
|00004bd0| 68 65 20 64 65 66 61 75 | 6c 74 20 64 65 62 75 67 |he defau|lt debug|
|00004be0| 20 73 74 72 65 61 6d 20 | 74 6f 20 6e 75 6c 6c 20 | stream |to null |
|00004bf0| 75 6e 74 69 6c 20 79 6f | 75 20 61 72 65 20 72 65 |until yo|u are re|
|00004c00| 61 64 79 20 74 6f 20 75 | 73 65 20 74 68 65 20 64 |ady to u|se the d|
|00004c10| 65 62 75 67 20 6f 75 74 | 70 75 74 20 61 67 61 69 |ebug out|put agai|
|00004c20| 6e 2e 0d 46 57 5f 43 4e | 75 6c 6c 44 65 62 75 67 |n..FW_CN|ullDebug|
|00004c30| 53 74 72 65 61 6d 20 73 | 75 62 63 6c 61 73 73 65 |Stream s|ubclasse|
|00004c40| 73 0d 54 68 65 72 65 20 | 61 72 65 20 6e 6f 20 73 |s.There |are no s|
|00004c50| 75 62 63 6c 61 73 73 65 | 73 20 6f 66 20 74 68 69 |ubclasse|s of thi|
|00004c60| 73 20 63 6c 61 73 73 2e | 0d 52 65 6c 61 74 65 64 |s class.|.Related|
|00004c70| 20 63 6c 61 73 73 65 73 | 0d 54 68 65 20 44 65 62 | classes|.The Deb|
|00004c80| 75 67 20 43 6f 6d 70 6f | 6e 65 6e 74 20 70 72 6f |ug Compo|nent pro|
|00004c90| 76 69 64 65 73 20 63 6c | 61 73 73 65 73 20 74 68 |vides cl|asses th|
|00004ca0| 61 74 20 61 6c 6c 6f 77 | 20 79 6f 75 20 74 6f 20 |at allow| you to |
|00004cb0| 6f 75 74 70 75 74 20 66 | 75 6e 64 61 6d 65 6e 74 |output f|undament|
|00004cc0| 61 6c 20 74 79 70 65 73 | 2c 20 70 6f 69 6e 74 65 |al types|, pointe|
|00004cd0| 72 73 2c 20 61 6e 64 20 | 6e 75 6c 6c 2d 74 65 72 |rs, and |null-ter|
|00004ce0| 6d 69 6e 61 74 65 64 20 | 73 74 72 69 6e 67 73 20 |minated |strings |
|00004cf0| 74 6f 20 61 20 64 65 62 | 75 67 20 73 74 72 65 61 |to a deb|ug strea|
|00004d00| 6d 2c 20 61 6e 64 20 63 | 72 65 61 74 65 20 6d 65 |m, and c|reate me|
|00004d10| 6d 6f 72 79 20 61 6e 64 | 20 66 69 6c 65 20 64 65 |mory and| file de|
|00004d20| 62 75 67 20 73 74 72 65 | 61 6d 73 2c 20 61 73 20 |bug stre|ams, as |
|00004d30| 66 6f 6c 6c 6f 77 73 3a | 0d a5 09 46 57 5f 43 44 |follows:|...FW_CD|
|00004d40| 65 62 75 67 53 74 72 65 | 61 6d 20 28 70 61 67 65 |ebugStre|am (page|
|00004d50| 20 31 31 29 0d a5 09 46 | 57 5f 43 42 75 66 66 65 | 11)...F|W_CBuffe|
|00004d60| 72 44 65 62 75 67 53 74 | 72 65 61 6d 09 20 28 70 |rDebugSt|ream. (p|
|00004d70| 61 67 65 20 31 35 29 0d | a5 09 46 57 5f 43 46 69 |age 15).|..FW_CFi|
|00004d80| 6c 65 44 65 62 75 67 53 | 74 72 65 61 6d 20 28 70 |leDebugS|tream (p|
|00004d90| 61 67 65 20 31 37 29 0d | 53 75 62 63 6c 61 73 73 |age 17).|Subclass|
|00004da0| 69 6e 67 20 46 57 5f 43 | 4e 75 6c 6c 44 65 62 75 |ing FW_C|NullDebu|
|00004db0| 67 53 74 72 65 61 6d 0d | 59 6f 75 20 75 73 75 61 |gStream.|You usua|
|00004dc0| 6c 6c 79 20 64 6f 20 6e | 6f 74 20 73 75 62 63 6c |lly do n|ot subcl|
|00004dd0| 61 73 73 20 74 68 69 73 | 20 63 6c 61 73 73 2e 0d |ass this| class..|
|00004de0| 46 57 5f 43 4e 75 6c 6c | 44 65 62 75 67 53 74 72 |FW_CNull|DebugStr|
|00004df0| 65 61 6d 20 4d 65 74 68 | 6f 64 73 0d 0d 46 57 5f |eam Meth|ods..FW_|
|00004e00| 43 4e 75 6c 6c 44 65 62 | 75 67 53 74 72 65 61 6d |CNullDeb|ugStream|
|00004e10| 28 29 3b 0d 0d 45 6d 70 | 74 79 20 63 6f 6e 73 74 |();..Emp|ty const|
|00004e20| 72 75 63 74 6f 72 2e 0d | 0d 76 69 72 74 75 61 6c |ructor..|.virtual|
|00004e30| 20 7e 46 57 5f 43 4e 75 | 6c 6c 44 65 62 75 67 53 | ~FW_CNu|llDebugS|
|00004e40| 74 72 65 61 6d 28 29 3b | 0d 0d 45 6d 70 74 79 20 |tream();|..Empty |
|00004e50| 64 65 73 74 72 75 63 74 | 6f 72 2e 0d 0d 76 69 72 |destruct|or...vir|
|00004e60| 74 75 61 6c 20 46 57 5f | 43 44 65 62 75 67 53 74 |tual FW_|CDebugSt|
|00004e70| 72 65 61 6d 20 26 57 72 | 69 74 65 28 63 6f 6e 73 |ream &Wr|ite(cons|
|00004e80| 74 20 76 6f 69 64 20 2a | 64 61 74 61 2c 0d 09 09 |t void *|data,...|
|00004e90| 09 09 09 09 09 09 09 09 | 73 69 7a 65 5f 74 20 73 |........|size_t s|
|00004ea0| 69 7a 65 29 3b 0d 0d 57 | 72 69 74 65 73 20 64 61 |ize);..W|rites da|
|00004eb0| 74 61 20 69 6e 74 6f 20 | 61 20 6e 75 6c 6c 20 64 |ta into |a null d|
|00004ec0| 65 62 75 67 20 73 74 72 | 65 61 6d 2e 20 54 68 65 |ebug str|eam. The|
|00004ed0| 20 64 65 62 75 67 20 6f | 75 74 70 75 74 20 69 73 | debug o|utput is|
|00004ee0| 20 69 67 6e 6f 72 65 64 | 2e 0d 46 57 5f 43 54 72 | ignored|..FW_CTr|
|00004ef0| 61 63 65 52 75 6e 74 69 | 6d 65 20 43 6c 61 73 73 |aceRunti|me Class|
|00004f00| 0d 49 6e 74 72 6f 64 75 | 63 74 69 6f 6e 0d 46 57 |.Introdu|ction.FW|
|00004f10| 5f 43 54 72 61 63 65 52 | 75 6e 74 69 6d 65 20 70 |_CTraceR|untime p|
|00004f20| 72 6f 76 69 64 65 73 20 | 66 75 6e 63 74 69 6f 6e |rovides |function|
|00004f30| 20 74 72 61 63 69 6e 67 | 20 63 61 70 61 62 69 6c | tracing| capabil|
|00004f40| 69 74 69 65 73 20 74 68 | 61 74 20 63 61 6e 20 62 |ities th|at can b|
|00004f50| 65 20 75 73 65 66 75 6c | 20 69 6e 20 73 6f 6d 65 |e useful| in some|
|00004f60| 20 73 69 74 75 61 74 69 | 6f 6e 73 2e 20 46 75 6e | situati|ons. Fun|
|00004f70| 63 74 69 6f 6e 20 74 72 | 61 63 69 6e 67 20 74 61 |ction tr|acing ta|
|00004f80| 6b 65 73 20 61 64 76 61 | 6e 74 61 67 65 20 6f 66 |kes adva|ntage of|
|00004f90| 20 63 6f 6d 70 69 6c 65 | 72 20 73 75 70 70 6f 72 | compile|r suppor|
|00004fa0| 74 20 74 6f 20 69 6e 73 | 65 72 74 20 61 20 63 61 |t to ins|ert a ca|
|00004fb0| 6c 6c 20 74 6f 20 61 20 | 73 70 65 63 69 61 6c 20 |ll to a |special |
|00004fc0| d2 66 75 6e 63 74 69 6f | 6e 20 65 6e 74 72 79 d3 |.functio|n entry.|
|00004fd0| 20 66 75 6e 63 74 69 6f | 6e 20 61 73 20 74 68 65 | functio|n as the|
|00004fe0| 20 66 69 72 73 74 20 69 | 6e 73 74 72 75 63 74 69 | first i|nstructi|
|00004ff0| 6f 6e 20 6f 66 20 65 76 | 65 72 79 20 66 75 6e 63 |on of ev|ery func|
|00005000| 74 69 6f 6e 2c 20 61 6e | 64 20 73 69 6d 69 6c 61 |tion, an|d simila|
|00005010| 72 6c 79 20 61 20 d2 66 | 75 6e 63 74 69 6f 6e 20 |rly a .f|unction |
|00005020| 65 78 69 74 d3 20 66 75 | 6e 63 74 69 6f 6e 20 61 |exit. fu|nction a|
|00005030| 73 20 74 68 65 20 6c 61 | 73 74 20 69 6e 73 74 72 |s the la|st instr|
|00005040| 75 63 74 69 6f 6e 20 6f | 66 20 65 76 65 72 79 20 |uction o|f every |
|00005050| 66 75 6e 63 74 69 6f 6e | 2e 20 4f 50 46 20 70 72 |function|. OPF pr|
|00005060| 6f 76 69 64 65 73 20 69 | 6d 70 6c 65 6d 65 6e 74 |ovides i|mplement|
|00005070| 61 74 69 6f 6e 73 20 6f | 66 20 74 68 65 73 65 20 |ations o|f these |
|00005080| 66 75 6e 63 74 69 6f 6e | 73 20 61 73 20 73 74 61 |function|s as sta|
|00005090| 74 69 63 20 6d 65 74 68 | 6f 64 73 20 6f 66 20 74 |tic meth|ods of t|
|000050a0| 68 69 73 20 63 6c 61 73 | 73 2e 20 54 68 65 20 72 |his clas|s. The r|
|000050b0| 65 73 75 6c 74 69 6e 67 | 20 62 65 68 61 76 69 6f |esulting| behavio|
|000050c0| 72 20 69 73 20 74 68 61 | 74 2c 20 77 68 65 6e 65 |r is tha|t, whene|
|000050d0| 76 65 72 20 61 20 74 72 | 61 63 65 64 20 66 75 6e |ver a tr|aced fun|
|000050e0| 63 74 69 6f 6e 20 69 73 | 20 65 6e 74 65 72 65 64 |ction is| entered|
|000050f0| 2c 20 61 20 6c 69 6e 65 | 20 6f 66 20 74 65 78 74 |, a line| of text|
|00005100| 20 69 73 20 6f 75 74 70 | 75 74 20 74 6f 20 74 68 | is outp|ut to th|
|00005110| 65 20 74 72 61 63 65 20 | 73 74 72 65 61 6d 20 69 |e trace |stream i|
|00005120| 6e 64 69 63 61 74 69 6e | 67 20 74 68 65 20 66 75 |ndicatin|g the fu|
|00005130| 6e 63 74 69 6f 6e 20 6e | 61 6d 65 20 61 6e 64 20 |nction n|ame and |
|00005140| 6e 65 73 74 69 6e 67 20 | 6c 65 76 65 6c 2e 20 57 |nesting |level. W|
|00005150| 68 65 6e 20 74 68 65 20 | 66 75 6e 63 74 69 6f 6e |hen the |function|
|00005160| 20 65 78 69 74 73 2c 20 | 61 6e 6f 74 68 65 72 20 | exits, |another |
|00005170| 6c 69 6e 65 20 6f 66 20 | 74 65 78 74 20 69 73 20 |line of |text is |
|00005180| 6f 75 74 70 75 74 20 74 | 6f 20 74 68 65 20 74 72 |output t|o the tr|
|00005190| 61 63 65 20 73 74 72 65 | 61 6d 20 69 6e 64 69 63 |ace stre|am indic|
|000051a0| 61 74 69 6e 67 20 74 68 | 65 20 66 75 6e 63 74 69 |ating th|e functi|
|000051b0| 6f 6e 20 65 78 69 74 2e | 20 54 72 61 63 65 20 6f |on exit.| Trace o|
|000051c0| 75 74 70 75 74 20 6c 6f | 6f 6b 73 20 73 6f 6d 65 |utput lo|oks some|
|000051d0| 74 68 69 6e 67 20 6c 69 | 6b 65 20 74 68 69 73 3a |thing li|ke this:|
|000051e0| 0d 0d 3e 20 6d 61 69 6e | 28 29 0d 3e 3e 66 6f 6f |..> main|().>>foo|
|000051f0| 28 29 0d 3e 3e 3e 46 6f | 6f 53 75 62 31 28 29 0d |().>>>Fo|oSub1().|
|00005200| 3c 3c 3c 46 6f 6f 53 75 | 62 31 28 29 0d 3e 3e 3e |<<<FooSu|b1().>>>|
|00005210| 46 6f 6f 53 75 62 32 28 | 29 0d 3c 3c 3c 46 6f 6f |FooSub2(|).<<<Foo|
|00005220| 53 75 62 32 28 29 0d 3c | 3c 66 6f 6f 28 29 0d 3c |Sub2().<|<foo().<|
|00005230| 6d 61 69 6e 28 29 0d 0d | 41 20 73 65 72 69 65 73 |main()..|A series|
|00005240| 20 6f 66 20 27 3e 27 20 | 63 68 61 72 61 63 74 65 | of '>' |characte|
|00005250| 72 73 20 69 6e 64 69 63 | 61 74 65 20 74 68 61 74 |rs indic|ate that|
|00005260| 20 61 20 66 75 6e 63 74 | 69 6f 6e 20 77 61 73 20 | a funct|ion was |
|00005270| 65 6e 74 65 72 65 64 2e | 20 41 20 73 65 72 69 65 |entered.| A serie|
|00005280| 73 20 6f 66 20 27 3c 27 | 20 69 6e 64 69 63 61 74 |s of '<'| indicat|
|00005290| 65 20 74 68 61 74 20 61 | 20 66 75 6e 63 74 69 6f |e that a| functio|
|000052a0| 6e 20 77 61 73 20 65 78 | 69 74 65 64 2e 20 54 68 |n was ex|ited. Th|
|000052b0| 65 20 6e 75 6d 62 65 72 | 20 6f 66 20 63 68 61 72 |e number| of char|
|000052c0| 61 63 74 65 72 73 20 69 | 6e 64 69 63 61 74 65 20 |acters i|ndicate |
|000052d0| 74 68 65 20 6e 65 73 74 | 69 6e 67 20 64 65 70 74 |the nest|ing dept|
|000052e0| 68 2e 0d 46 57 5f 43 54 | 72 61 63 65 52 75 6e 74 |h..FW_CT|raceRunt|
|000052f0| 69 6d 65 20 73 68 6f 75 | 6c 64 20 6e 65 76 65 72 |ime shou|ld never|
|00005300| 20 62 65 20 69 6e 73 74 | 61 6e 74 69 61 74 65 64 | be inst|antiated|
|00005310| 2e 20 41 6c 6c 20 6f 66 | 20 69 74 73 20 6d 65 74 |. All of| its met|
|00005320| 68 6f 64 73 20 61 72 65 | 20 73 74 61 74 69 63 2c |hods are| static,|
|00005330| 20 74 68 61 74 20 69 73 | 2c 20 74 68 65 72 65 20 | that is|, there |
|00005340| 69 73 20 6f 6e 6c 79 20 | 6f 6e 65 20 63 6f 70 79 |is only |one copy|
|00005350| 20 6f 66 20 65 61 63 68 | 20 6d 65 74 68 6f 64 20 | of each| method |
|00005360| 66 6f 72 20 74 68 65 20 | 65 6e 74 69 72 65 20 63 |for the |entire c|
|00005370| 6c 61 73 73 2c 20 61 6e | 64 20 65 61 63 68 20 6d |lass, an|d each m|
|00005380| 65 74 68 6f 64 20 63 61 | 6e 20 62 65 20 61 63 63 |ethod ca|n be acc|
|00005390| 65 73 73 65 64 20 77 69 | 74 68 6f 75 74 20 61 6e |essed wi|thout an|
|000053a0| 20 6f 62 6a 65 63 74 2e | 20 54 68 65 72 65 66 6f | object.| Therefo|
|000053b0| 72 65 2c 20 6e 6f 20 69 | 6e 73 74 61 6e 63 65 20 |re, no i|nstance |
|000053c0| 69 73 20 72 65 71 75 69 | 72 65 64 2e 0d 48 65 61 |is requi|red..Hea|
|000053d0| 64 65 72 20 66 69 6c 65 | 0d 46 57 54 72 61 63 65 |der file|.FWTrace|
|000053e0| 2e 68 0d 48 65 72 69 74 | 61 67 65 0d 46 57 5f 43 |.h.Herit|age.FW_C|
|000053f0| 44 65 62 75 67 43 6f 6e | 73 6f 6c 65 09 37 0d 46 |DebugCon|sole.7.F|
|00005400| 57 5f 43 44 65 62 75 67 | 53 74 72 65 61 6d 09 31 |W_CDebug|Stream.1|
|00005410| 31 0d a5 20 46 57 5f 43 | 42 75 66 66 65 72 44 65 |1.. FW_C|BufferDe|
|00005420| 62 75 67 53 74 72 65 61 | 6d 09 31 35 0d a5 20 46 |bugStrea|m.15.. F|
|00005430| 57 5f 43 46 69 6c 65 44 | 65 62 75 67 53 74 72 65 |W_CFileD|ebugStre|
|00005440| 61 6d 09 31 37 0d a5 20 | 46 57 5f 43 4e 75 6c 6c |am.17.. |FW_CNull|
|00005450| 44 65 62 75 67 53 74 72 | 65 61 6d 09 31 39 0d 46 |DebugStr|eam.19.F|
|00005460| 57 5f 43 54 72 61 63 65 | 52 75 6e 74 69 6d 65 0d |W_CTrace|Runtime.|
|00005470| 55 73 69 6e 67 20 46 57 | 5f 43 54 72 61 63 65 52 |Using FW|_CTraceR|
|00005480| 75 6e 74 69 6d 65 0d 55 | 73 65 20 46 57 5f 43 54 |untime.U|se FW_CT|
|00005490| 72 61 63 65 52 75 6e 74 | 69 6d 65 20 74 6f 20 69 |raceRunt|ime to i|
|000054a0| 6e 69 74 69 61 6c 69 7a | 65 20 74 72 61 63 69 6e |nitializ|e tracin|
|000054b0| 67 20 75 73 69 6e 67 20 | 74 68 65 20 49 6e 69 74 |g using |the Init|
|000054c0| 69 61 6c 69 7a 65 28 29 | 20 6d 65 74 68 6f 64 2c |ialize()| method,|
|000054d0| 20 70 61 73 73 69 6e 67 | 20 69 6e 20 74 68 65 20 | passing| in the |
|000054e0| 64 65 62 75 67 20 73 74 | 72 65 61 6d 20 74 6f 20 |debug st|ream to |
|000054f0| 72 65 63 65 69 76 65 20 | 74 68 65 20 6f 75 74 70 |receive |the outp|
|00005500| 75 74 2e 20 42 65 20 73 | 75 72 65 20 74 6f 20 75 |ut. Be s|ure to u|
|00005510| 73 65 20 61 20 46 57 5f | 43 46 69 6c 65 44 65 62 |se a FW_|CFileDeb|
|00005520| 75 67 53 74 72 65 61 6d | 20 28 6f 72 20 61 20 64 |ugStream| (or a d|
|00005530| 65 62 75 67 20 73 74 72 | 65 61 6d 20 6f 66 20 79 |ebug str|eam of y|
|00005540| 6f 75 72 20 6f 77 6e 29 | 20 73 6f 20 74 68 61 74 |our own)| so that|
|00005550| 20 74 68 65 20 64 65 62 | 75 67 20 73 74 72 65 61 | the deb|ug strea|
|00005560| 6d 20 63 61 6e 20 72 65 | 63 65 69 76 65 20 6c 6f |m can re|ceive lo|
|00005570| 74 73 20 6f 66 20 6f 75 | 74 70 75 74 2e 20 55 73 |ts of ou|tput. Us|
|00005580| 65 20 74 68 65 20 53 74 | 61 72 74 54 72 61 63 65 |e the St|artTrace|
|00005590| 28 29 20 61 6e 64 20 53 | 74 6f 70 54 72 61 63 65 |() and S|topTrace|
|000055a0| 28 29 20 6d 65 74 68 6f | 64 73 20 74 6f 20 73 70 |() metho|ds to sp|
|000055b0| 65 63 69 66 79 20 77 68 | 69 63 68 20 62 6f 64 69 |ecify wh|ich bodi|
|000055c0| 65 73 20 6f 66 20 63 6f | 64 65 20 79 6f 75 20 77 |es of co|de you w|
|000055d0| 61 6e 74 20 74 6f 20 74 | 72 61 63 65 2e 20 4a 75 |ant to t|race. Ju|
|000055e0| 64 69 63 69 6f 75 73 20 | 70 6c 61 63 65 6d 65 6e |dicious |placemen|
|000055f0| 74 20 6f 66 20 74 68 65 | 73 65 20 6d 65 74 68 6f |t of the|se metho|
|00005600| 64 73 20 63 61 6e 20 72 | 65 64 75 63 65 20 74 68 |ds can r|educe th|
|00005610| 65 20 61 6d 6f 75 6e 74 | 20 6f 66 20 74 72 61 63 |e amount| of trac|
|00005620| 65 20 6f 75 74 70 75 74 | 2e 20 46 69 6e 61 6c 6c |e output|. Finall|
|00005630| 79 2c 20 63 61 6c 6c 20 | 74 68 65 20 54 65 72 6d |y, call |the Term|
|00005640| 69 6e 61 74 65 28 29 20 | 6d 65 74 68 6f 64 20 77 |inate() |method w|
|00005650| 68 65 6e 20 79 6f 75 20 | 61 72 65 20 64 6f 6e 65 |hen you |are done|
|00005660| 20 74 72 61 63 69 6e 67 | 2e 0d 46 57 5f 43 54 72 | tracing|..FW_CTr|
|00005670| 61 63 65 52 75 6e 74 69 | 6d 65 20 73 75 62 63 6c |aceRunti|me subcl|
|00005680| 61 73 73 65 73 0d 54 68 | 65 72 65 20 61 72 65 20 |asses.Th|ere are |
|00005690| 6e 6f 20 73 75 62 63 6c | 61 73 73 65 73 20 6f 66 |no subcl|asses of|
|000056a0| 20 74 68 69 73 20 63 6c | 61 73 73 2e 0d 52 65 6c | this cl|ass..Rel|
|000056b0| 61 74 65 64 20 63 6c 61 | 73 73 65 73 0d 54 72 61 |ated cla|sses.Tra|
|000056c0| 63 65 20 6f 75 74 70 75 | 74 20 69 73 20 73 65 6e |ce outpu|t is sen|
|000056d0| 74 20 74 6f 20 61 20 64 | 65 62 75 67 20 73 74 72 |t to a d|ebug str|
|000056e0| 65 61 6d 2e 20 59 6f 75 | 20 73 68 6f 75 6c 64 20 |eam. You| should |
|000056f0| 6e 6f 72 6d 61 6c 6c 79 | 20 75 73 65 20 61 20 46 |normally| use a F|
|00005700| 57 5f 43 46 69 6c 65 44 | 65 62 75 67 53 74 72 65 |W_CFileD|ebugStre|
|00005710| 61 6d 20 66 6f 72 20 74 | 68 65 20 6f 75 74 70 75 |am for t|he outpu|
|00005720| 74 2c 20 73 69 6e 63 65 | 20 74 72 61 63 69 6e 67 |t, since| tracing|
|00005730| 20 6e 6f 72 6d 61 6c 6c | 79 20 70 72 6f 64 75 63 | normall|y produc|
|00005740| 65 73 20 61 20 6c 6f 74 | 20 6f 66 20 6f 75 74 70 |es a lot| of outp|
|00005750| 75 74 2e 0d 53 75 62 63 | 6c 61 73 73 69 6e 67 20 |ut..Subc|lassing |
|00005760| 46 57 5f 43 54 72 61 63 | 65 52 75 6e 74 69 6d 65 |FW_CTrac|eRuntime|
|00005770| 0d 59 6f 75 20 6e 65 76 | 65 72 20 73 75 62 63 6c |.You nev|er subcl|
|00005780| 61 73 73 20 74 68 69 73 | 20 63 6c 61 73 73 2e 0d |ass this| class..|
|00005790| 46 57 5f 43 54 72 61 63 | 65 52 75 6e 74 69 6d 65 |FW_CTrac|eRuntime|
|000057a0| 20 4d 65 74 68 6f 64 73 | 0d 0d 73 74 61 74 69 63 | Methods|..static|
|000057b0| 20 76 6f 69 64 20 44 65 | 63 72 54 72 61 63 65 44 | void De|crTraceD|
|000057c0| 65 70 74 68 28 29 3b 0d | 0d 54 68 69 73 20 69 73 |epth();.|.This is|
|000057d0| 20 61 6e 20 69 6e 74 65 | 72 6e 61 6c 20 6d 65 74 | an inte|rnal met|
|000057e0| 68 6f 64 20 69 6e 74 65 | 6e 64 65 64 20 66 6f 72 |hod inte|nded for|
|000057f0| 20 75 73 65 20 62 79 20 | 42 46 43 20 6f 6e 6c 79 | use by |BFC only|
|00005800| 2e 0d 0d 73 74 61 74 69 | 63 20 76 6f 69 64 20 44 |...stati|c void D|
|00005810| 75 6d 70 4f 6e 65 4c 69 | 6e 65 28 46 57 5f 43 44 |umpOneLi|ne(FW_CD|
|00005820| 65 62 75 67 53 74 72 65 | 61 6d 26 0d 09 09 09 09 |ebugStre|am&.....|
|00005830| 09 09 09 09 74 72 61 63 | 65 53 74 72 65 61 6d 2c |....trac|eStream,|
|00005840| 0d 09 09 09 09 09 09 09 | 09 75 6e 73 69 67 6e 65 |........|.unsigne|
|00005850| 64 20 73 68 6f 72 74 20 | 64 65 70 74 68 2c 0d 09 |d short |depth,..|
|00005860| 09 09 09 09 09 09 09 53 | 74 65 70 49 6e 4f 75 74 |.......S|tepInOut|
|00005870| 20 64 69 72 65 63 74 69 | 6f 6e 2c 0d 09 09 09 09 | directi|on,.....|
|00005880| 09 09 09 09 63 6f 6e 73 | 74 20 63 68 61 72 2a 20 |....cons|t char* |
|00005890| 70 72 6f 63 4e 61 6d 65 | 29 3b 0d 0d 54 68 69 73 |procName|);..This|
|000058a0| 20 69 73 20 61 6e 20 69 | 6e 74 65 72 6e 61 6c 20 | is an i|nternal |
|000058b0| 6d 65 74 68 6f 64 20 69 | 6e 74 65 6e 64 65 64 20 |method i|ntended |
|000058c0| 66 6f 72 20 75 73 65 20 | 62 79 20 42 46 43 20 6f |for use |by BFC o|
|000058d0| 6e 6c 79 2e 0d 0d 0d 76 | 6f 69 64 20 5f 46 57 5f |nly....v|oid _FW_|
|000058e0| 43 54 72 61 63 65 52 75 | 6e 74 69 6d 65 3a 3a 44 |CTraceRu|ntime::D|
|000058f0| 75 6d 70 4f 6e 65 4c 69 | 6e 65 0d 09 09 09 09 09 |umpOneLi|ne......|
|00005900| 09 28 46 57 5f 43 44 65 | 62 75 67 53 74 72 65 61 |.(FW_CDe|bugStrea|
|00005910| 6d 26 20 74 72 61 63 65 | 53 74 72 65 61 6d 2c 0d |m& trace|Stream,.|
|00005920| 09 09 09 09 09 09 63 6f | 6e 73 74 20 63 68 61 72 |......co|nst char|
|00005930| 2a 20 70 7a 50 72 65 66 | 69 78 2c 0d 09 09 09 09 |* pzPref|ix,.....|
|00005940| 09 09 75 6e 73 69 67 6e | 65 64 20 68 4d 6f 64 75 |..unsign|ed hModu|
|00005950| 6c 65 2c 0d 09 09 09 09 | 09 09 75 6e 73 69 67 6e |le,.....|..unsign|
|00005960| 65 64 20 77 53 65 67 6d | 65 6e 74 2c 0d 09 09 09 |ed wSegm|ent,....|
|00005970| 09 09 09 75 6e 73 69 67 | 6e 65 64 20 77 4f 66 66 |...unsig|ned wOff|
|00005980| 73 65 74 29 0d 0d 54 68 | 69 73 20 69 73 20 61 6e |set)..Th|is is an|
|00005990| 20 69 6e 74 65 72 6e 61 | 6c 20 6d 65 74 68 6f 64 | interna|l method|
|000059a0| 20 69 6e 74 65 6e 64 65 | 64 20 66 6f 72 20 75 73 | intende|d for us|
|000059b0| 65 20 62 79 20 42 46 43 | 20 6f 6e 6c 79 2e 0d 0d |e by BFC| only...|
|000059c0| 73 74 61 74 69 63 20 76 | 6f 69 64 20 49 6e 63 72 |static v|oid Incr|
|000059d0| 54 72 61 63 65 44 65 70 | 74 68 28 29 3b 0d 0d 54 |TraceDep|th();..T|
|000059e0| 68 69 73 20 69 73 20 61 | 6e 20 69 6e 74 65 72 6e |his is a|n intern|
|000059f0| 61 6c 20 6d 65 74 68 6f | 64 20 69 6e 74 65 6e 64 |al metho|d intend|
|00005a00| 65 64 20 66 6f 72 20 75 | 73 65 20 62 79 20 42 46 |ed for u|se by BF|
|00005a10| 43 20 6f 6e 6c 79 2e 0d | 0d 73 74 61 74 69 63 20 |C only..|.static |
|00005a20| 73 68 6f 72 74 20 49 6e | 69 74 69 61 6c 69 7a 65 |short In|itialize|
|00005a30| 28 46 57 5f 43 44 65 62 | 75 67 53 74 72 65 61 6d |(FW_CDeb|ugStream|
|00005a40| 20 2a 74 72 61 63 65 53 | 74 72 65 61 6d 29 3b 0d | *traceS|tream);.|
|00005a50| 0d 41 63 71 75 69 72 65 | 73 20 74 68 65 20 72 65 |.Acquire|s the re|
|00005a60| 73 6f 75 72 63 65 73 20 | 6e 65 65 64 65 64 20 66 |sources |needed f|
|00005a70| 6f 72 20 74 72 61 63 69 | 6e 67 20 61 6e 64 20 70 |or traci|ng and p|
|00005a80| 72 65 70 61 72 65 73 20 | 74 6f 20 74 72 61 63 65 |repares |to trace|
|00005a90| 2e 20 43 6c 69 65 6e 74 | 73 20 6d 75 73 74 20 65 |. Client|s must e|
|00005aa0| 6e 73 75 72 65 20 74 68 | 61 74 20 74 68 65 20 74 |nsure th|at the t|
|00005ab0| 72 61 63 65 20 73 74 72 | 65 61 6d 20 69 73 20 6f |race str|eam is o|
|00005ac0| 70 65 6e 65 64 20 66 6f | 72 20 77 72 69 74 69 6e |pened fo|r writin|
|00005ad0| 67 2e 20 52 65 74 75 72 | 6e 73 20 7a 65 72 6f 20 |g. Retur|ns zero |
|00005ae0| 69 66 20 69 74 20 63 6f | 75 6c 64 20 6e 6f 74 20 |if it co|uld not |
|00005af0| 69 6e 69 74 69 61 6c 69 | 7a 65 2c 20 6e 6f 6e 2d |initiali|ze, non-|
|00005b00| 7a 65 72 6f 20 69 66 20 | 69 74 20 77 61 73 20 73 |zero if |it was s|
|00005b10| 75 63 63 65 73 73 66 75 | 6c 2e 0d 0d 73 74 61 74 |uccessfu|l...stat|
|00005b20| 69 63 20 76 6f 69 64 20 | 53 74 61 72 74 54 72 61 |ic void |StartTra|
|00005b30| 63 65 28 29 3b 0d 0d 53 | 74 61 72 74 73 20 28 72 |ce();..S|tarts (r|
|00005b40| 65 73 75 6d 65 73 29 20 | 74 72 61 63 69 6e 67 20 |esumes) |tracing |
|00005b50| 74 6f 20 74 68 65 20 74 | 72 61 63 65 20 73 74 72 |to the t|race str|
|00005b60| 65 61 6d 2e 20 41 6e 20 | 65 72 72 6f 72 20 69 73 |eam. An |error is|
|00005b70| 20 67 65 6e 65 72 61 74 | 65 64 20 69 66 20 79 6f | generat|ed if yo|
|00005b80| 75 20 61 74 74 65 6d 70 | 74 20 74 6f 20 73 74 61 |u attemp|t to sta|
|00005b90| 72 74 20 74 72 61 63 69 | 6e 67 20 77 69 74 68 6f |rt traci|ng witho|
|00005ba0| 75 74 20 61 20 73 75 63 | 63 65 73 73 66 75 6c 20 |ut a suc|cessful |
|00005bb0| 63 61 6c 6c 20 74 6f 20 | 49 6e 69 74 69 61 6c 69 |call to |Initiali|
|00005bc0| 7a 65 28 29 2e 0d 0d 73 | 74 61 74 69 63 20 76 6f |ze()...s|tatic vo|
|00005bd0| 69 64 20 53 74 6f 70 54 | 72 61 63 65 28 29 3b 0d |id StopT|race();.|
|00005be0| 0d 53 74 6f 70 73 20 28 | 73 75 73 70 65 6e 64 73 |.Stops (|suspends|
|00005bf0| 29 20 74 72 61 63 69 6e | 67 20 74 6f 20 74 68 65 |) tracin|g to the|
|00005c00| 20 74 72 61 63 65 20 73 | 74 72 65 61 6d 2e 0d 0d | trace s|tream...|
|00005c10| 73 74 61 74 69 63 20 76 | 6f 69 64 20 54 65 72 6d |static v|oid Term|
|00005c20| 69 6e 61 74 65 28 29 3b | 0d 0d 52 65 6c 65 61 73 |inate();|..Releas|
|00005c30| 65 73 20 72 65 73 6f 75 | 72 63 65 73 20 61 63 71 |es resou|rces acq|
|00005c40| 75 69 72 65 64 20 66 6f | 72 20 74 72 61 63 69 6e |uired fo|r tracin|
|00005c50| 67 2e 20 43 6c 69 65 6e | 74 73 20 63 61 6e 20 6e |g. Clien|ts can n|
|00005c60| 6f 77 20 63 6c 6f 73 65 | 20 74 68 65 20 74 72 61 |ow close| the tra|
|00005c70| 63 65 20 73 74 72 65 61 | 6d 2e 0d 0d 73 74 61 74 |ce strea|m...stat|
|00005c80| 69 63 20 76 6f 69 64 20 | 54 72 61 63 65 49 6e 28 |ic void |TraceIn(|
|00005c90| 29 3b 0d 0d 54 68 69 73 | 20 69 73 20 61 6e 20 69 |);..This| is an i|
|00005ca0| 6e 74 65 72 6e 61 6c 20 | 6d 65 74 68 6f 64 20 69 |nternal |method i|
|00005cb0| 6e 74 65 6e 64 65 64 20 | 66 6f 72 20 75 73 65 20 |ntended |for use |
|00005cc0| 62 79 20 42 46 43 20 6f | 6e 6c 79 2e 0d 0d 73 74 |by BFC o|nly...st|
|00005cd0| 61 74 69 63 20 76 6f 69 | 64 20 54 72 61 63 65 4f |atic voi|d TraceO|
|00005ce0| 75 74 28 29 3b 0d 0d 54 | 68 69 73 20 69 73 20 61 |ut();..T|his is a|
|00005cf0| 6e 20 69 6e 74 65 72 6e | 61 6c 20 6d 65 74 68 6f |n intern|al metho|
|00005d00| 64 20 69 6e 74 65 6e 64 | 65 64 20 66 6f 72 20 75 |d intend|ed for u|
|00005d10| 73 65 20 62 79 20 42 46 | 43 20 6f 6e 6c 79 2e 0d |se by BF|C only..|
|00005d20| 15 48 00 00 00 00 03 18 | 02 64 00 11 02 ff 0c 00 |.H......|.d......|
|00005d30| ff ff ff ff 00 00 00 00 | 00 00 00 00 02 64 00 00 |........|.....d..|
|00005d40| 03 18 00 00 00 00 00 00 | 00 01 00 0a 00 00 00 00 |........|........|
|00005d50| 03 18 02 64 00 0a 00 00 | 00 00 00 00 00 00 00 34 |...d....|.......4|
|00005d60| 02 b4 00 6c 02 be 02 0a | 00 2c 00 08 00 14 05 54 |...l....|.,.....T|
|00005d70| 69 6d 65 73 00 03 00 14 | 00 04 02 00 00 0d 00 0a |imes....|........|
|00005d80| 00 2e 00 04 00 00 01 00 | 00 15 fd 60 00 28 02 bb |........|...`.(..|
|00005d90| 01 8f 14 4f 50 46 20 52 | 65 66 65 72 65 6e 63 65 |...OPF R|eference|
|00005da0| 20 4d 61 6e 75 61 6c 00 | 00 29 76 01 31 00 00 0a | Manual.|.)v.1...|
|00005db0| ff ff ff ff ff ff ff ff | 00 74 00 1e 00 b4 01 f8 |........|.t......|
|00005dc0| 00 c6 02 0a 00 bd 02 0a | 00 c6 02 01 00 bd 01 f8 |........|........|
|00005dd0| 00 b4 02 01 00 bd 02 0a | 00 70 00 1e 00 b4 01 f8 |........|.p......|
|00005de0| 00 c6 02 0a 00 bd 02 0a | 00 c6 02 01 00 bd 01 f8 |........|........|
|00005df0| 00 b4 02 01 00 bd 02 0a | 00 20 00 bd 00 6c 00 bd |........|. ...l..|
|00005e00| 01 ef 00 04 03 00 00 0d | 00 24 00 15 c5 00 00 a1 |........|.$......|
|00005e10| 00 64 00 10 4f 4e 4c 4e | 00 64 00 00 00 7b 01 8a |.d..ONLN|.d...{..|
|00005e20| 00 9f 01 eb 00 28 00 96 | 01 8a 05 44 65 62 75 67 |.....(..|...Debug|
|00005e30| 00 15 bb 00 00 a1 00 64 | 00 10 4f 4e 4c 4e 00 64 |.......d|..ONLN.d|
|00005e40| 00 06 00 9f 01 40 00 c3 | 01 ec 00 28 00 ba 01 40 |.....@..|...(...@|
|00005e50| 09 43 6f 6d 70 6f 6e 65 | 6e 74 00 15 c0 00 00 a1 |.Compone|nt......|
|00005e60| 00 64 00 10 4f 4e 4c 4e | 00 64 ff ff 00 00 00 00 |.d..ONLN|.d......|
|00005e70| 00 00 00 00 00 2b 9a 24 | 01 31 00 04 01 00 00 0d |.....+.$|.1......|
|00005e80| 00 0f 00 a1 00 64 00 10 | 4f 4e 4c 4e 00 64 00 11 |.....d..|ONLN.d..|
|00005e90| 01 04 00 e1 01 13 01 32 | 00 28 01 0f 00 e1 0c 49 |.......2|.(.....I|
|00005ea0| 6e 74 72 6f 64 75 63 74 | 69 6f 6e 00 00 04 00 00 |ntroduct|ion.....|
|00005eb0| 00 0d 00 0a 00 06 ff ff | b6 1a 00 a1 00 64 00 10 |........|.....d..|
|00005ec0| 4f 4e 4c 4e 00 64 00 1e | 01 18 00 e1 01 24 00 f2 |ONLN.d..|.....$..|
|00005ed0| 00 2a 12 04 54 68 65 20 | 00 15 42 1a 00 a1 00 64 |.*..The |..B....d|
|00005ee0| 00 10 4f 4e 4c 4e 00 64 | 00 22 01 18 00 f3 01 24 |..ONLN.d|.".....$|
|00005ef0| 01 3c 00 29 12 0f 44 65 | 62 75 67 20 63 6f 6d 70 |.<.)..De|bug comp|
|00005f00| 6f 6e 65 6e 74 00 00 15 | 8f 94 00 a1 00 64 00 10 |onent...|.....d..|
|00005f10| 4f 4e 4c 4e 00 64 00 31 | 01 18 01 3c 01 24 02 09 |ONLN.d.1|...<.$..|
|00005f20| 00 29 49 37 20 63 6f 6e | 74 61 69 6e 73 20 74 6f |.)I7 con|tains to|
|00005f30| 6f 6c 73 20 74 68 61 74 | 20 61 72 65 20 75 73 65 |ols that| are use|
|00005f40| 66 75 6c 20 64 75 72 69 | 6e 67 20 74 68 65 20 74 |ful duri|ng the t|
|00005f50| 65 73 74 69 6e 67 20 61 | 6e 64 20 00 00 06 00 00 |esting a|nd .....|
|00005f60| 00 00 00 a1 00 64 00 10 | 4f 4e 4c 4e 00 64 00 68 |.....d..|ONLN.d.h|
|00005f70| 01 24 00 e1 01 30 01 43 | 00 28 01 2d 00 e1 17 64 |.$...0.C|.(.-...d|
|00005f80| 65 62 75 67 67 69 6e 67 | 20 6f 66 20 4f 50 46 20 |ebugging| of OPF |
|00005f90| 70 61 72 74 73 2e 00 a1 | 00 64 00 10 4f 4e 4c 4e |parts...|.d..ONLN|
|00005fa0| 00 64 00 80 01 3a 00 e1 | 01 46 00 f3 00 2a 16 04 |.d...:..|.F...*..|
|00005fb0| 54 68 65 20 00 15 8c 00 | 00 a1 00 64 00 10 4f 4e |The ....|...d..ON|
|00005fc0| 4c 4e 00 64 00 84 01 3a | 00 f3 01 46 01 3c 00 29 |LN.d...:|...F.<.)|
|00005fd0| 12 0f 44 65 62 75 67 20 | 63 6f 6d 70 6f 6e 65 6e |..Debug |componen|
|00005fe0| 74 00 00 15 23 60 00 a1 | 00 64 00 10 4f 4e 4c 4e |t...#`..|.d..ONLN|
|00005ff0| 00 64 00 93 01 3a 01 3d | 01 46 01 cd 00 29 4a 24 |.d...:.=|.F...)J$|
|00006000| 20 70 72 6f 76 69 64 65 | 73 20 74 68 65 20 66 6f | provide|s the fo|
|00006010| 6c 6c 6f 77 69 6e 67 20 | 64 65 62 75 67 20 74 6f |llowing |debug to|
|00006020| 6f 6c 73 3a 00 a1 00 64 | 00 10 4f 4e 4c 4e 00 64 |ols:...d|..ONLN.d|
|00006030| 00 b8 01 50 00 f3 01 5c | 00 f6 00 28 01 59 00 f3 |...P...\|...(.Y..|
|00006040| 01 a5 00 15 4c cd 00 a1 | 00 64 00 10 4f 4e 4c 4e |....L...|.d..ONLN|
|00006050| 00 64 00 ba 01 50 00 fe | 01 5c 01 3d 00 29 0b 0e |.d...P..|.\.=.)..|
|00006060| 44 65 62 75 67 20 63 6f | 6e 73 6f 6c 65 73 00 a1 |Debug co|nsoles..|
|00006070| 00 64 00 10 4f 4e 4c 4e | 00 64 00 c9 01 5c 00 f3 |.d..ONLN|.d...\..|
|00006080| 01 68 00 f6 00 28 01 65 | 00 f3 01 a5 00 15 4c cd |.h...(.e|......L.|
|00006090| 00 a1 00 64 00 10 4f 4e | 4c 4e 00 64 00 cb 01 5c |...d..ON|LN.d...\|
|000060a0| 00 fe 01 68 01 be 00 29 | 0b 2f 4d 61 63 72 6f 73 |...h...)|./Macros|
|000060b0| 20 77 68 69 63 68 20 64 | 69 72 65 63 74 20 65 72 | which d|irect er|
|000060c0| 72 6f 72 73 20 74 6f 20 | 74 68 65 20 64 65 62 75 |rors to |the debu|
|000060d0| 67 20 63 6f 6e 73 6f 6c | 65 00 00 a1 00 64 00 10 |g consol|e....d..|
|000060e0| 4f 4e 4c 4e 00 64 00 fb | 01 68 00 f3 01 74 00 f6 |ONLN.d..|.h...t..|
|000060f0| 00 28 01 71 00 f3 01 a5 | 00 15 4c cd 00 a1 00 64 |.(.q....|..L....d|
|00006100| 00 10 4f 4e 4c 4e 00 64 | 00 fd 01 68 00 fe 01 74 |..ONLN.d|...h...t|
|00006110| 01 39 00 29 0b 0d 44 65 | 62 75 67 20 73 74 72 65 |.9.)..De|bug stre|
|00006120| 61 6d 73 00 00 a1 00 64 | 00 10 4f 4e 4c 4e 00 64 |ams....d|..ONLN.d|
|00006130| 01 0b 01 74 00 f3 01 80 | 00 f6 00 28 01 7d 00 f3 |...t....|...(.}..|
|00006140| 01 a5 00 15 4c cd 00 a1 | 00 64 00 10 4f 4e 4c 4e |....L...|.d..ONLN|
|00006150| 00 64 01 0d 01 74 00 fe | 01 80 01 64 00 29 0b 1b |.d...t..|...d.)..|
|00006160| 46 75 6e 63 74 69 6f 6e | 20 74 72 61 63 69 6e 67 |Function| tracing|
|00006170| 20 66 61 63 69 6c 69 74 | 69 65 73 00 00 04 01 00 | facilit|ies.....|
|00006180| 00 0d 00 0f 00 a1 00 64 | 00 10 4f 4e 4c 4e 00 64 |.......d|..ONLN.d|
|00006190| 01 29 01 8b 00 e1 01 9a | 01 59 00 28 01 96 00 e1 |.)......|.Y.(....|
|000061a0| 0f 44 65 62 75 67 20 43 | 6f 6d 70 6f 6e 65 6e 74 |.Debug C|omponent|
|000061b0| 00 15 ee a0 00 a1 00 64 | 00 10 4f 4e 4c 4e 00 64 |.......d|..ONLN.d|
|000061c0| 01 38 01 8b 01 59 01 9a | 01 9a 00 29 78 09 20 4f |.8...Y..|...)x. O|
|000061d0| 76 65 72 76 69 65 77 00 | 00 04 00 00 00 0d 00 0a |verview.|........|
|000061e0| 00 06 ff ff d3 5f 00 a1 | 00 64 00 10 4f 4e 4c 4e |....._..|.d..ONLN|
|000061f0| 00 64 01 42 01 9f 00 e1 | 01 ab 00 f2 00 28 01 a8 |.d.B....|.....(..|
|00006200| 00 e1 04 54 68 65 20 00 | 00 15 5f 5f 00 a1 00 64 |...The .|..__...d|
|00006210| 00 10 4f 4e 4c 4e 00 64 | 01 46 01 9f 00 f3 01 ab |..ONLN.d|.F......|
|00006220| 01 3c 00 29 12 0f 44 65 | 62 75 67 20 63 6f 6d 70 |.<.)..De|bug comp|
|00006230| 6f 6e 65 6e 74 00 00 15 | ca 1e 00 a1 00 64 00 10 |onent...|.....d..|
|00006240| 4f 4e 4c 4e 00 64 01 55 | 01 9f 01 3c 01 ab 02 09 |ONLN.d.U|...<....|
|00006250| 00 29 49 34 20 63 6f 6e | 74 61 69 6e 73 20 36 20 |.)I4 con|tains 6 |
|00006260| 63 6c 61 73 73 65 73 20 | 61 6e 64 20 34 35 20 6d |classes |and 45 m|
|00006270| 65 74 68 6f 64 73 2e 20 | 59 6f 75 20 77 69 6c 6c |ethods. |You will|
|00006280| 20 6c 69 6b 65 6c 79 20 | 00 06 ff ff a0 79 00 a1 | likely |.....y..|
|00006290| 00 64 00 10 4f 4e 4c 4e | 00 64 01 89 01 ab 00 e1 |.d..ONLN|.d......|
|000062a0| 01 b7 01 a0 00 28 01 b4 | 00 e1 31 6e 65 65 64 20 |.....(..|..1need |
|000062b0| 74 6f 20 6b 6e 6f 77 20 | 61 62 6f 75 74 2c 20 61 |to know |about, a|
|000062c0| 6e 64 20 75 73 65 2c 20 | 74 68 65 20 6d 61 6a 6f |nd use, |the majo|
|000062d0| 72 69 74 79 20 6f 66 20 | 74 68 65 20 00 15 44 3a |rity of |the ..D:|
|000062e0| 00 a1 00 64 00 10 4f 4e | 4c 4e 00 64 01 ba 01 ab |...d..ON|LN.d....|
|000062f0| 01 a1 01 b7 01 ea 00 29 | c0 0f 44 65 62 75 67 20 |.......)|..Debug |
|00006300| 63 6f 6d 70 6f 6e 65 6e | 74 00 00 15 7c 13 00 a1 |componen|t...|...|
|00006310| 00 64 00 10 4f 4e 4c 4e | 00 64 01 c9 01 ab 01 ea |.d..ONLN|.d......|
|00006320| 01 b7 02 0a 00 29 49 09 | 20 63 6c 61 73 73 65 73 |.....)I.| classes|
|00006330| 20 00 00 06 00 00 00 00 | 00 a1 00 64 00 10 4f 4e | .......|...d..ON|
|00006340| 4c 4e 00 64 01 d2 01 b7 | 00 e1 01 c3 01 16 00 28 |LN.d....|.......(|
|00006350| 01 c0 00 e1 0c 61 6e 64 | 20 6d 65 74 68 6f 64 73 |.....and| methods|
|00006360| 2e 00 00 04 01 00 00 0d | 00 0c 00 a1 00 64 00 10 |........|.....d..|
|00006370| 4f 4e 4c 4e 00 64 01 df | 01 ce 00 e1 01 da 01 12 |ONLN.d..|........|
|00006380| 00 2a 17 09 44 69 72 65 | 63 74 6f 72 79 00 00 2c |.*..Dire|ctory..,|
|00006390| 00 0a 00 16 07 43 6f 75 | 72 69 65 72 00 03 00 16 |.....Cou|rier....|
|000063a0| 00 04 00 00 00 0d 00 0a | 00 2e 00 04 00 00 00 00 |........|........|
|000063b0| 00 a1 00 64 00 10 4f 4e | 4c 4e 00 64 01 e9 01 dc |...d..ON|LN.d....|
|000063c0| 00 e1 01 e8 01 0b 00 2a | 0e 07 46 57 44 65 62 75 |.......*|..FWDebu|
|000063d0| 67 00 00 03 00 14 00 04 | 01 00 00 0d 00 0c 00 2e |g.......|........|
|000063e0| 00 04 00 00 01 00 00 a1 | 00 64 00 10 4f 4e 4c 4e |........|.d..ONLN|
|000063f0| 00 64 01 f1 01 f3 00 e1 | 01 ff 01 0d 00 2a 17 08 |.d......|.....*..|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.